SWPlus (Mod)

A collective of Quality of Life additives.

Getting Started

Getting Started

About SWPM

Why the Mod Started

SWE/M has grown into a collection of mods where some features, recipes, or items/blocks may seem out of place as there was no better place to put them however we really wanted them. SWPM began as a 'kitchen sink mod' where we dumped all the unfitting bits into one place to clean up the other mods we develop. This mod is mainly for the use in our own servers with our preferences, however its public if others want to use it too.


What does SWPM Include?

This mod aims to add a collective of Quality of Life Additives. 


Disclaimer

Several recipes can be found in other small standalone mods, some of which are now outdated. The Star Worm team hoped to have a consolidated mod offering a collection of QOL additions to improve gameplay and minimize the number of individual mods required for SW server modlists and community members. Where possible, all credits for the recipes themselves have been given to those who created the original recipes, or to members of the community who suggested new recipes. Additionally, all features added in are proudly credited to those who aided in their development.

Getting Started

Credits

Credits for development on SWPM are listed below!


Version - Forge 1.18.2

Owner and Production Lead - AlaharranHonor

Programming

Primary: Silverwolf

Secondary: Legenden

Mentions: Umpaz

Textures

Primary: AlaharranHonor

Secondary: Cytris

Mentions: Silverwolf

Wiki

Primary: Delphi

Mentions: AlaharranHonor

Recipes added have been individually credited in their wiki entry wherever possible. Its possible another had created the content before us but the credits accurately reflect where we specifically had gotten the ideas from.

Recipes

The recipes section outlines recipes for vanilla items, improved by the SWPM mod.

Recipes

Black Dye

Description: Black dye can be crafted from charcoal.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
1 black dye can be crafted with 1 Charcoal.

image-1673735341886.png


Usage

(Black) Dye is a vanilla item. See: Minecraft Wiki


Known Issues


Data values

Recipes

Chests

Description: Craft chests in bulk.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
4 chests can be crafted with 8 Logs.

image-1673727674042.png


Usage

Chests are a vanilla item. See: Minecraft Wiki


Known Issues


Data values


Recipes

Dirt

Description: Create dirt from leaves and rotten flesh.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
Dirt can be crafted with 1 Leaf Block and 1 Rotten Flesh.

image-1673727968810.png

Credits for the crafting recipe go to RandomGuy32.


Usage

Dirt is a vanilla item. See: Minecraft Wiki


Known Issues


 

Data values

Recipes

Flint

Description: Create flint with a crafting recipe, or by smelting.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
1 flint can be crafted with 3 Gravel.

image-1673726650652.png

Smelting
Quartz can be smelted down into 1 flint.

image-1673735505844.png

Credits for the crafting recipe (gravel > flint) go to celester.


Usage

Flint is a vanilla item. See: Minecraft Wiki


Known Issues


Data values

Recipes

Flowers

Description: Duplicate flowers with seeds.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
4 flowers can be crafted with 1 Flower (any vanilla) and 3 Seeds (wheat).

image-1673733324797.png

Credits for the crafting recipe go to Rhea.


Usage

Flowers are vanilla items. See: Minecraft Wiki


Known Issues


Data values

Recipes

Grass Block

Description: Create grass blocks from dirt and seeds or grass.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
A grass block can be crafted with 1 Dirt Block and 1 Seed (wheat).

image-1673728363901.png

A grass block can be crafted with 1 Dirt Block and 1 Grass.

image-1673728375614.png

Credits for the crafting recipe go to RandomGuy32.


Usage

Grass block is a vanilla item. See: Minecraft Wiki


Known Issues


Data values

Recipes

Horse Saddle (Vanilla)

Description: Craft vanilla horse saddles.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
A horse saddle can be crafted with 3 Leather, 2 Tripwire Hooks and 1 Carpet.

image-1673736752302.png


Usage

Horse saddles (as shown) are a vanilla item. See: Minecraft Wiki


Known Issues


Data values

Recipes

Horse Armor (Vanilla)

Description: Craft vanilla horse armor.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Iron

 An iron horse armor (vanilla) can be crafted with 3 Carpet, 3 Iron, 2 Tripwire Hooks and 2 Leather.

image-1673735859282.png

Gold

 A gold horse armor (vanilla) can be crafted with 3 Carpet, 3 Gold Ingots, 2 Tripwire Hooks and 2 Leather.

image-1673735914865.png

Diamond

A diamond horse armor (vanilla) can be crafted with 3 Carpet, 3 Diamonds, 2 Tripwire Hooks and 2 Leather.

image-1673736120819.png


Usage

Crafting Ingredient
Leather horse armor can be uncrafted into 3 Leather.

image-1673737197573.png
Iron horse armor can be smelted (uncrafted) into 1 Iron Ingot.

image-1673737518539.png

Gold Horse Armor can be smelted (uncrafted) into 1 Gold (TBC)

[ IMAGE MISSING ]

Horse Armors (as shown) are a vanilla item. See: Minecraft Wiki


Known Issues


Data values

Recipes

Iron

Description: Iron can be uncrafted from various items.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Smelting
Iron horse armor (vanilla) can be uncrafted into 1 Iron Ingot.

image-1673738764103.png

Minecarts can be smelted down into 1 Iron Ingot.

image-1673735696286.png

Credits for the crafting recipe go to BjossiAlfreds.


Usage

Iron is a vanilla item. See: Minecraft Wiki


Known Issues


Data values

Recipes

Leather

Description: Leather can be uncrafted from vanilla Minecraft saddles.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
3 leather can be crafted with 1 Saddle (Vanilla) or 1 Leather Horse Armor (Vanilla).

image-1673732489842.png

image-1673737331796.png

Credits for the crafting recipe go to BjossiAlfreds.


Usage

Leather is a vanilla item. See: Minecraft Wiki


Known Issues


 

Data values

Recipes

Name Tag

Description: Create name tags without needing to find loot chests.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
4 name tags can be crafted with 1 Sign (any vanilla), 1 Gold Nugget and 1 String.

image-1673725114797.png

Credits for the crafting recipe go to Rhea.


Usage

Name tags are a vanilla item. See: Minecraft Wiki


Known Issues


 

Data values

Recipes

Podzol

Description: Create podzol from dirt and spruce leaves.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
1 podzol can be crafted with 1 Spruce Leaf Block and 1 Dirt Block.

image-1673734148075.png

Credits for the crafting recipe go to Yindee8191.


Usage

Podzol is a vanilla item. See: Minecraft Wiki


Known Issues


Data values

Recipes

Quartz

Description: Quartz can be uncrafted from a Quartz block.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
4 quartz can be crafted with 1 Quartz Block.

image-1673730377339.png

Credits for the crafting recipe go to Kybo50.


Usage

Quartz is a vanilla item. See: Minecraft Wiki


Known Issues


 

Data values

Recipes

Sapling

Description: Create saplings from logs and leaves.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
A sapling can be created using 1 Log and 1 Leaf Block of a corresponding type - all vanilla wood and leaf types can be crafted into their corresponding sapling.

image-1673729877235.png

Credits for the crafting recipe go to MrBrobot.


Usage

Saplings are a vanilla item. See: Minecraft Wiki


Known Issues


 

Data values

Recipes

Slimeball

Description: Create slimeballs with water and rotten flesh.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
1 slimeball can be crafted with 1 Bucket of Water and 1 Rotten Flesh.

image-1673735081344.png

Credits for the crafting recipe go to Flyboiz.


Usage

Slimeballs are a vanilla item. See: Minecraft Wiki


Known Issues


 

Data values

Recipes

Stick

Description: Create sticks from logs and saplings.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
A stick can be crafted with 1 Sapling.

image-1673727282670.png

16 sticks can be crafted with 1 Logs.

image-1673727412287.png

Credits for the crafting recipe (logs > stick) go to celester.
Credits for the crafting recipe (sapling > stick) go to Seb_Romu.


Usage

Sticks are a vanilla item. See: Minecraft Wiki


Known Issues


Data values

Recipes

String

Description: String can be uncrafted from wool blocks.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
4 string can be crafted with 1 wool.

image-1673732111293.png

Credits for the crafting recipe go to epharian.


Usage

String is a vanilla item. See: Minecraft Wiki


Known Issues


 

Data values

Recipes

Torches

Description: Craft torches in bulk.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
32 torches can be crafted with 1 Coal Block and 1 Log (any vanilla).

image-1673722315725.png


Usage

Torches are a vanilla lighting item. See: Minecraft Wiki


Known Issues


Data values

minecraft:torch

Recipes

Tripwire Hook

Description: Create tripwire hooks in bulk.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
8 tripwire hooks can be crafted with 1 Iron Ingot, 1 String and 1 Wood Plank (any vanilla).

image-1673726172671.png


Usage

Tripwire hooks are a vanilla item. See: Minecraft Wiki


Known Issues


 

Data values

Recipes

Wool

Description: Recolor wool with dye.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
You can recolor wool to a new color using 8 Wool and 1 Dye.

Recipes

image-1673725502835.png

image-1673724210637.png

image-1673724222275.png

image-1673724235994.png

image-1673724248473.png

image-1673724284089.png

image-1673724262782.png

image-1673724308226.png

image-1673724321593.png

image-1673724390073.png

image-1673724404567.png

image-1673724420660.png

image-1673724442515.png

image-1673724456996.png

image-1673724469656.png

image-1673724481838.png

It is not necessary to have all of the same color wool to recolor.

image-1673725907734.png

image-1673725921732.png

Credits for the crafting recipe go to acemccrank.


Usage

Wool blocks are a vanilla item. See: Minecraft Wiki


Known Issues


Data values

Items

The items section outlines unique (new) items added by the SWPM mod.

Items

Healing Items

Description: Healing Items are a group of items that can heal passive mobs and the player.


Details: 

Rarity color: Common
Renewable: Yes
Stackable: Yes (64)
Durability: Yes (Single Use)

Obtaining

Loot Spawn
Healing items can spawn in loot containers around the world; villages, dungeons, and loot containers provided by other mods. 

Crafting

Salve

Salve is crafted with Honey Bottle and Slime. It can be used with a Bandage to make a Medicated Bandage.
It heals 2 full Hearts (4 Health).

image-1661125075357.png

Bandage

A Bandage is made by using 2 White Carpets. Salve can be added to the Bandage to make a Medicated Bandage.
It heals 1 full Heart (2 Health).

image-1661125089491.png

Medicated Bandage

A Medicated Bandage is made with a Bandage and Salve.
It heals 3 full Hearts (6 Health).

image-1661125099195.png


Usage

 

Right click and hold to apply to self. Right click to a passive mob to heal it.

Items

Paint Filler

Description: Paint Filler is an item that can be used to increase the amount of color dyes.


Details: 

Rarity color: Common
Renewable: Yes
Stackable: Yes (64)

Obtaining

Crafting
Paint Filler can be crafted with 1 Water Bucket and 1 Slime
Paint Filler can also be crafted with Star Worm Goop from SWLM and SWEM.

paint filler.png


Usage

Crafting ingredient
Paint Filler can be combined with any dye to produce 4 dyes of that color.

paint filler use.png


Data values

Items

Mercy Blade

Description: Mercy Blade offers a swift one-hit kill to passive entities.


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting
A mercy blade can be crafted with 1 Bone and 1 Poppy.

image-1673723633943.png


Usage

Left click a passive mob with a mercy blade in hand to use it. This offers a one-hit kill and the animal will not make any sound that is usually produced when harmed. Normal mob loot will be dropped.

Mercy blades can be enchanted in an enchanting table, or combined with an enchanted book in an anvil.


Known Issues


 

Data values

Items

SWPM (Template)

Description: 


Details: 

Rarity color: --
Renewable: --
Stackable: --
Durability: --

Obtaining

Crafting


Usage



Known Issues


 

Data values

Blocks

The blocks section outlines unique (new) blocks added by the SWPM mod.

Blocks

Charcoal Block

Description: A condensed charcoal block.


Details: 

Rarity color: Common
Renewable: Yes
Stackable: Yes (64)
Durability: None

Obtaining

Crafting
A charcoal block can be crafted with 9 Charcoal.

image-1673720435004.png


Usage

Charcoal Blocks can sustain a permanent fire, similar to Netherack or coal ore, when lit with a flint and steel. They can also be placed in furnaces, blast furnaces or smokers to power them. They are equal to 10 coal or charcoal (800 seconds - up to 800 items per block) - the same as coal blocks. As charcoal can be easily produced with logs, charcoal blocks represent a relatively cheap and easy alternative to coal for smelting. 


Known Issues


Data values

Blocks

Fuel Block

Description: A Fuel Block can be used as a source of fuel for Furnaces.


Details: 

Renewable: Yes

Stackable:

Yes (64)
Tool: Pickaxe (Any)
Blast Resistance: N/A
Hardness: N/A
Luminant: No
Transparent: No
Flammable: No (See Usage)
Flammable (Lava): No

Obtaining

Crafting
A Fuel Block can be crafted with 8 Dirt and 1 Flint.

image-1673723099059.png


Usage

Fuel Blocks can sustain a permanent fire, similar to netherack or coal ore, when lit with a flint and steel. They can also be placed in furnaces, blast furnaces or smokers to power them. They are equal to coal or charcoal (80 seconds - up to 8 items per unit) but 1/10th as long-lasting as coal or charcoal blocks (800 seconds - up to 80 items per block). However, all materials used to craft fuel blocks are nearly infinite and easily found or produced, as well as often being considered a waste or limited use resource, so represent a relatively cheap and easy alternative to coal for smelting. 

fuel.png


Data Values

Functions

The functions section outlines unique (new) QOL functions and features added by the SWPM mod.

Functions

Role Permission Keys

This function is currently in development and is being expanded - not all features are implemented.

SWPM keys are not substitute for a rank mod that limits use of Minecraft commands, or the commands of other mods.

Note: These permissions and restrictions are primarily being developed for use in official SWE servers, but are included in the mod for others needing similar functions for server management. The keys determined reflect the roles within our community and staff team, but have been adapted to generic role names for easy application on other servers. 

Note: Role Permission Keys are by default only useful for multiplayer servers. This wiki page will assume multiplayer use.


Getting Started

Keys permit a user to access a specific set of commands relevant to the role (key). Currently non-configurable.
The list of commands accessible to each Key is listed below under the Key name.

To begin using the Keys:

A server manager with console access will need to run this command to assign the Owner Key. 

/swpm assign key <player> swpm:owner

From there, the player with the Owner Key can then assign the necessary Keys to the desired staff.
The below Index states which Keys give which commands/permissions.

The Owner Key should not be given to anyone who is not absolutely necessary. The Owner Key grants access to assigning/revoking any Key to/from any player.

Why is the Owner Key required when normally all access is given via OP?

This mod is made to run on multiplayer servers which assumes the use of rankings, staff, and protections of dangerous permissions from undesirable uses. Some mods require OP access to be given to players to do tasks below the Mod/Admin level (e.g. World Edit and volunteer/paid Builders). It was deemed unsafe to make OP access default as any lower level staff with OP for tasks like building, could then assign/revoke any Key from anyone.


Key Rankings

Each set of commands is exclusive to the Key, regardless of ranking, meaning multiple keys will be required to run commands from different 'sets'. This Key system is based on hierarchy logic which assumes that an Admin will most likely need to be a Mod first before being promoted, therefore an Admin will already have the Mod Key and its permissions.

Ranks

The Keys are ordered by rank. More dangerous permissions are given to higher level ranks, like Mod or Admin.
Currently Active Keys (highest rank to lowest) with Assigned Minecraft Colors:

  1. Owner (Blue)
  2. Admin (Yellow)
  3. Mod (Gold)

Assigned/revoked by Admin Key and higher ranking. Technically not within Rankings.
Other:

  1. Blacklist Bypass (Black)

Default Access

There is currently no Key needed to run these commands. 

This is intended in future to have these permissions transferred to the Player Key, requiring a permission system to obtain the Player Key. e.g. SWPM would automatically assign the Player Key once the player has agreed to the rules, to then gain access to the server.

N/A Give a player the Player key.
Available commands
/swpm fly Toggles creative flight within a permitted area. See Gamemode Locks.
/swpm key list Lists all keys assigned to your player.
/swpm onDuty list Lists all the staff members currently on duty. See 

More commands will be available only if the player has additional Keys assigned, regardless of rank.


Jail Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Audit Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Player Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Donator Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Helper Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Filming Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Assistant Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Staff Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Admin Assist Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Builder Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Mod Key (Active)

This Key permits approved server staff (Mod level) to list Keys of other players, go on/off duty, and teleport through obstacles.

/swpm key assign [playername] swpm:mod Give a player the Mod key.
Available commands
/swpm key list <player> Lists all Keys assigned to a specific player other than oneself.
/swpm onDuty <on/off> Marks oneself as On/Off Duty.
/swpm thru Teleports the player through an obstacles.

More commands will be available only if the player has additional Keys assigned, regardless of rank.


Admin Key (Active)

This Key permits approved server staff (Admin level) to view/remove/add Gamemode Locks, as well as assign or revoke Keys.

/swpm key assign [playername] swpm:admin Give a player the Admin key.
Available commands
/swpm gamemode list List gamemode locks for current dimension +/- TP to center point.
/swpm gamemode remove [dimension] [true/false] Removes a gamemode lock in the current region/dimension you are standing in.
/swpm gamemode [gamemode] set [@/player] dimension [true/false] Add a new gamemode lock in the current dimension.
/swpm gamemode [gamemode] set [@/player] name <coords> [true/false] Add a new gamemode lock between the set coordinates (cube).
/swpm key <assign/revoke> [playername] [key] Assigns/Revokes any lower ranking key to/from another player(s).

More commands will be available only if the player has additional Keys assigned, regardless of rank.


Head Admin Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Co-Owner Key (Inactive)

This key is currently inactive - assigning this key offers no additional access to commands.


Owner Key (Active)

This key serves the sole purpose of giving a player access to assign/revoke any key from any player. This Key can only be given through console. Once given, the Owner can then assign Keys as needed, such as Mod or Admin Keys.

/swpm key assign <playername> swpm:owner Give a player the Owner key.
Available commands
/swpm key <assign/revoke> <playername> <key> Assign/Revoke any lower ranking key to/from another player(s).

More commands will be available only if the player has additional Keys assigned, regardless of rank.


Blacklist Bypass Key (Active)

This key permits approved server staff to be exempt from item confiscation by the Blacklist feature.
If assigned, a player with the Blacklist Bypass Key will be able to keep (in their inventory) any item which would otherwise be deleted moments after being taken, picked up, or transferred into an inventory.


Changelog

View Changes

This is not a complete list of version changes / fixes. It is a changelog of relevant wiki-related version information.

MC Version Release Notes
1.18.2 1.18.2-2.1.0 New feature - added permissions keys.
Functions

Gamemode Locks

Gamemode Locks are a feature added by SWPM that allows hosts to designate specific areas/dimensions with a set gamemode.


View Gamemode Locks

Gamemode Locks can only be viewed/edited by players with the Admin Key (SWPM) and within the applicable dimension.

/swpm gamemode list                                                         List all gamemode locks in the current dimension.


Create a Gamemode Lock (Basic)

Gamemode Locks can only be set by players with the Admin Key (SWPM).

/swpm gamemode [gamemode] [@/player] dimension <true/false>     
Creates a gamemode lock in the current dimension, dis/allowing the /swpm fly command for the effected players.

EXAMPLE
/swpm gamemode set adventure @a dimension false
--- Puts all players (@a) into adventure mode when in the current dimension, disallowing /swpm fly.

/swpm gamemode set [gamemode] [@/player] <gamemode lock name> [coords] <true/false>       
Creates a gamemode lock within a set coordinates, with a specific name, dis/allowing the /swpm fly command for the effected players.

EXAMPLE
/swpm gamemode set survival @a region Woot -377 78 -18 -415 75 40 false
--- Puts all players (@a) into survival mode within the set coordinates, disallowing the /swpm fly command.
--- The Gamemode Lock is named 'Woot'.

Create a Gamemode Lock (Advanced)

Gamemode locks can be set to exclude users in an approved group (such as a staff or moderator team).
When specified, the mod will not alter the gamemode of any players in the excluded group.

/swpm gamemode set adventure @a[team=!admin] dimension
--- Puts all players (@a) that are NOT in the admin team into adventure mode when in the current dimension.

Teams need to be set up separately (Minecraft feature) and players manually added to the team. Read more here.


Options (Explained)

Gamemode

Adventure

The player is mortal (can be killed), can explore the world but cannot place or destroy blocks.
Survival The player is mortal (can be killed) and may explore the world, place and destroy blocks.
Creative The player is immortal, has free access to any block in the game, instant destruction of blocks, creative flight.
Spectator The player is immortal, can fly through objects or the world, cannot interact with any items or entities.

Target

Target Selector

A selector such as @a (all players)
Player UN A specific player's username
Player UUID A specific player's user ID (UUID)

Range / Area

Dimension

A selector such as @a (all players)
Block Position Determine a cube selection of the desired area (selection) including height and depth. Specify the coordinates of two opposing corner blocks.

Edit or Remove a Gamemode Lock

Gamemode Locks can only be removed by players with the Admin Key (SWPM) who are located within the region/dimension Lock.

/swpm gamemode remove <name>                                       Removes a gamemode lock in the current region (position).

/swpm gamemode remove dimension                                 Removes a gamemode lock in the current dimension.

/swpm gamemode rename                                                    Renames the specified region Gamemode Lock.


Troubleshooting

Command fails

Cannot remove a Gamemode Lock


Changelog

View Changes

This is not a complete list of version changes / fixes. It is a changelog of relevant wiki-related version information.

MC Version Release Notes
1.18.2 1.18.2-2.1.0 New feature - added /gamemode command
Functions

Blacklist

Blacklisting can be setup by:

Once setup, blacklisted items will be removed from any player if they obtain it and a notice given that the item was confiscated.

Note: These permissions and restrictions are primarily being developed for use in official SWE servers, but are included in the mod for others needing similar functions for server management. The default configs may specify mods that servers do not use or do not want to blacklist - ensure the config reflects the correct restrictions of the server prior to re-loading the world.


Config

Check and adjust the config prior to applying to or updating servers - blacklisted inventory items will be permanently lost.

The below is our default entry for SWE server modpack and restrictions.

#List of item ids to blacklist from being mapped.
#Format: modid:itemid
#Example: minecraft:stone
blacklist_item_ids = ["minecraft:bedrock"]

#List of entity ids to blacklist from being mapped.
#Format: modid:entityid
#Example Entry: minecraft:iron_golem
#Example List: ["minecraft:iron_golem", "minecraft:villager", "minecraft:wither", "minecraft:mooshroom"]
blacklist_entity_ids = []

This says: Specify which items (by ID) that will be removed from a player once acquired, and which entities (by ID) that will be prevented from spawning.

The below is our default entry for SWE server modpack and restrictions.

#List of item ids to blacklist from being mapped.
#Format: modid:itemid
#Example: minecraft:stone
blacklist_item_ids = ["minecraft:bedrock", "minecraft:barrier", "minecraft:elytra", "minecraft:ender_chest", "minecraft:obsidian", "minecraft:ender_eye", "minecraft:end_crystal", "minecraft:wither_skeleton_skull", "minecraft:nether_star", "minecraft:chorus_fruit", "minecraft:budding_amethyst", "minecraft:tnt"]

#List of entity ids to blacklist from being mapped.
#Format: modid:entityid
#Example Entry: minecraft:iron_golem
#Example List: ["minecraft:iron_golem", "minecraft:villager", "minecraft:wither", "minecraft:mooshroom"]
blacklist_entity_ids = ["minecraft:iron_golem", "minecraft:villager", "minecraft:wither", "minecraft:mooshroom"]

This says: Specify which items (by ID) that will be removed from a player once acquired, and which entities (by ID) that will be prevented from spawning.


Commands

/swpm blacklist add modid:itemid                              Adds an item (by ID) to the blacklist.

/swpm blacklist remove modid:itemid                        Removes an item (by ID) from the blacklist.

/swpm blacklist list                                                    Lists all currently blacklisted items (allows blacklist removal via the list).

Blacklisted entities cannot be listed, added, or removed via commands. It is only possible through config.


Exemption

All users are subject to blacklist item confiscation except for anyone with the Blacklist Bypass key.

When an item is confiscated, the following message will display:

image.png

Functions

Command Functions

Note: These permissions and restrictions are primarily being developed for use in official SWE servers, but are included in the mod for others needing similar functions for server management. We are aware other mods might have added their own version of these commands, however to limit our modpack, we internalized the the ones we deemed most necessary.


Creative Flight (Gamemode Locks)

Gamemode Locks can allow creative flight to be activated within them. Upon set up, choose true (flight yes) or false (flight no).

To toggle flight, /swpm fly.
Access to this command does not require a Key.

This was primarily used for players building within their plot zones. We Gamemode Locked the dimension Plot dimensions to Adventure Mode, built premade plots, put Survival Gamemode Locks (regional) over the plots, then used FTBChunks for players to have access to edit their plot.


Thru

To teleport through an obstacle, /swpm thru.
Access to this command is given with the Mod Key.

This was primarily used for ease when building or access to staff only rooms in community service buildings as these buildings often didn't have doors to make illegal entry impossible.


OnDuty

OnDuty is a command to make it clear which staff are available and actively working on their tasks. Staff members that are on duty will have their chat messages in the relating color to their highest Key ranking and their name in that bolded color in the Online Player List (when pressing TAB).

To list staff currently on duty, /swpm onDuty list.
Access to this command does not require a Key.

To go on/off duty, /swpm onDuty <on/off>
This command will send a bolded message in chat.
Access to this command is given with the Mod Key.

image.png

image.png

Our staff were permitted and encouraged to play the server but struggled to find peace to play because of the players' constant wants and needs. Creating the onDuty system assisted in enforcing player respect of the staff's off duty hours while also tracking their on duty work hours.