# Functions

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

# Role Permission Keys

<p class="callout warning">This function is currently **in development** and is being expanded - not all features are implemented.</p>

<p class="callout warning">SWPM keys are not substitute for a rank mod that limits use of Minecraft commands, or the commands of other mods.</p>

**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.

<p class="callout danger">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.</p>

##### 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

<p class="callout success">There is currently no Key needed to run these commands. </p>

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.

<table border="1" id="bkmrk-%2Fswpm-key-assign-%5Bpl" style="border-collapse: collapse; width: 100%; height: 249.883px;"><colgroup><col style="width: 44.4983%;"></col><col style="width: 55.5017%;"></col></colgroup><tbody><tr style="height: 31.2891px;"><td style="height: 31.2891px;">N/A</td><td style="height: 31.2891px;">Give a player the Player key.</td></tr><tr style="height: 30.0391px;"><td class="align-center" colspan="2" style="height: 30.0391px;">**Available commands**</td></tr><tr style="height: 35.6445px;"><td style="height: 35.6445px;">`/swpm fly`</td><td style="height: 35.6445px;">Toggles creative flight within a permitted area. See [Gamemode Locks](https://wiki.swequestrian.com/books/swplus-mod/page/gamemode-locks).</td></tr><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm key list`</td><td style="height: 31.0938px;">Lists all keys assigned to your player.</td></tr><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm onDuty list`</td><td style="height: 31.0938px;">Lists all the staff members currently on duty. See </td></tr><tr style="height: 59.6289px;"><td colspan="2" style="height: 59.6289px;"><p class="callout warning">More commands will be available only if the player has additional Keys assigned, regardless of rank.</p>

</td></tr></tbody></table>

---

#### 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.

<table border="1" id="bkmrk-%2Fswpm-key-assign-%5Bpl-1" style="border-collapse: collapse; width: 100%; height: 245.137px;"><colgroup><col style="width: 44.5131%;"></col><col style="width: 55.5178%;"></col></colgroup><tbody><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm key assign [playername] swpm:mod`</td><td style="height: 31.0938px;">Give a player the Mod key.</td></tr><tr style="height: 30.0391px;"><td class="align-center" colspan="2" style="height: 30.0391px;">**Available commands**</td></tr><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm key list <player>`</td><td style="height: 31.0938px;">Lists all Keys assigned to a specific player other than oneself.</td></tr><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm onDuty <on/off>`</td><td style="height: 31.0938px;">Marks oneself as On/Off Duty.</td></tr><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm thru`</td><td style="height: 31.0938px;">Teleports the player through an obstacles.</td></tr><tr style="height: 59.6289px;"><td colspan="2" style="height: 59.6289px;"><p class="callout warning">More commands will be available only if the player has additional Keys assigned, regardless of rank.</p>

</td></tr></tbody></table>

---

#### Admin Key (Active)

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

<table border="1" id="bkmrk-%2Fswpm-key-assign-%5Bpl-2" style="border-collapse: collapse; width: 100%; height: 323.067px;"><colgroup><col style="width: 44.4983%;"></col><col style="width: 55.5017%;"></col></colgroup><tbody><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm key assign [playername] swpm:admin`</td><td style="height: 31.0938px;">Give a player the Admin key.</td></tr><tr style="height: 30.0391px;"><td class="align-center" colspan="2" style="height: 30.0391px;">**Available commands**</td></tr><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm gamemode list`</td><td style="height: 31.0938px;">List gamemode locks for current dimension +/- TP to center point.</td></tr><tr style="height: 46.8359px;"><td style="height: 46.8359px;">`/swpm gamemode remove [dimension] [true/false]`</td><td style="height: 46.8359px;">Removes a gamemode lock in the current region/dimension you are standing in.</td></tr><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm gamemode [gamemode] set [@/player] dimension [true/false]`</td><td style="height: 31.0938px;">Add a new gamemode lock in the current dimension.</td></tr><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm gamemode [gamemode] set [@/player] name <coords> [true/false]`</td><td style="height: 31.0938px;">Add a new gamemode lock between the set coordinates (cube).</td></tr><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm key <assign/revoke> [playername] [key]`</td><td style="height: 31.0938px;">Assigns/Revokes any lower ranking key to/from another player(s).</td></tr><tr style="height: 59.6289px;"><td colspan="2" style="height: 59.6289px;"><p class="callout warning">More commands will be available only if the player has additional Keys assigned, regardless of rank.</p>

</td></tr></tbody></table>

---

#### 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.

<table border="1" id="bkmrk-%2Fswpm-key-assign-%5Bpl-3" style="border-collapse: collapse; width: 100%; height: 369.512px;"><colgroup><col style="width: 44.5131%;"></col><col style="width: 55.5178%;"></col></colgroup><tbody><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm key assign <playername> swpm:owner`</td><td style="height: 31.0938px;">Give a player the Owner key.</td></tr><tr style="height: 30.0391px;"><td class="align-center" colspan="2" style="height: 30.0391px;">**Available commands**</td></tr><tr style="height: 31.0938px;"><td style="height: 31.0938px;">`/swpm key <assign/revoke> <playername> <key>`</td><td style="height: 31.0938px;">Assign/Revoke any lower ranking key to/from another player(s).</td></tr><tr style="height: 59.6289px;"><td colspan="2" style="height: 59.6289px;"><p class="callout warning">More commands will be available only if the player has additional Keys assigned, regardless of rank.</p>

</td></tr></tbody></table>

---

#### 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

<details id="bkmrk-this-is-not-a-comple"><summary>View Changes</summary>

<p class="callout info">This is not a complete list of version changes / fixes. It is a changelog of relevant wiki-related version information.</p>

<table border="1" style="border-collapse: collapse; width: 100%; height: 121.781px;"><tbody><tr style="height: 29.7969px;"><td class="align-center" style="width: 13.3504%; height: 29.7969px;">**MC Version**</td><td class="align-center" style="width: 20.0257%; height: 29.7969px;">**Release**</td><td class="align-center" style="width: 66.6239%; height: 29.7969px;">**Notes**</td></tr><tr><td style="width: 13.3504%;">1.18.2</td><td style="width: 20.0257%;">1.18.2-2.1.0</td><td style="width: 66.6239%;">New feature - added permissions keys.</td></tr></tbody></table>

</details>

# Gamemode Locks

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

- This gamemode will override the default setting of the world or server.
- This gamemode lock will automatically change the gamemode of any player that crosses into the area/dimension.
- This gamemode lock will not effect those with the correct keys to bypass. Please see [Role Permission Keys](https://wiki.swequestrian.com/books/swplus-mod/page/role-permission-keys).
- This gamemode can be set to apply to a specific dimension, or even a specific area within a dimension.  
    
    - This gamemode can "nest". An area Gamemode Lock will override a dimensional Gamemode Lock.

---

#### View Gamemode Locks

<p class="callout info">Gamemode Locks can only be viewed/edited by players with the Admin Key (SWPM) and within the applicable dimension.</p>

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

---

#### Create a Gamemode Lock (Basic)

<p class="callout info">Gamemode Locks can only be set by players with the Admin Key (SWPM).</p>

`/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](https://minecraft.fandom.com/wiki/Argument_types#block_pos), 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](https://minecraft.fandom.com/wiki/Commands/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.
```

<p class="callout info">Teams need to be set up separately (Minecraft feature) and players manually added to the team. Read more **[here](https://minecraft.fandom.com/wiki/Commands/team).**</p>

---

#### Options (Explained)

**Gamemode**

<table border="1" id="bkmrk-adventure-the-player" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 15.0797%;"></col><col style="width: 84.9203%;"></col></colgroup><tbody><tr><td>[**Adventure**](https://minecraft.fandom.com/wiki/Adventure)

</td><td>The player is mortal (can be killed), can explore the world but cannot place or destroy blocks.</td></tr><tr><td>**[Survival](https://minecraft.fandom.com/wiki/Survival)**</td><td>The player is mortal (can be killed) and may explore the world, place and destroy blocks.</td></tr><tr><td>**[Creative](https://minecraft.fandom.com/wiki/Creative)**</td><td>The player is immortal, has free access to any block in the game, instant destruction of blocks, creative flight.</td></tr><tr><td>**[Spectator](https://minecraft.fandom.com/wiki/Spectator)**</td><td>The player is immortal, can fly through objects or the world, cannot interact with any items or entities.</td></tr></tbody></table>

**Target**

<table border="1" id="bkmrk-target-selector-a-se" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 15.0762%;"></col><col style="width: 84.9238%;"></col></colgroup><tbody><tr><td>[**Target Selector**](https://minecraft.fandom.com/wiki/Target_selectors)

</td><td>A selector such as @a (all players)</td></tr><tr><td>**Player UN**</td><td>A specific player's username</td></tr><tr><td>**Player [UUID](https://minecraft.fandom.com/wiki/UUID)**</td><td>A specific player's user ID (UUID)</td></tr></tbody></table>

**Range / Area**

<table border="1" id="bkmrk-dimension-a-selector" style="border-collapse: collapse; width: 100%;"><colgroup><col style="width: 15.0762%;"></col><col style="width: 84.9238%;"></col></colgroup><tbody><tr><td>**Dimension**

</td><td>A selector such as @a (all players)</td></tr><tr><td>[**Block Position**](https://minecraft.fandom.com/wiki/Argument_types#block_pos)</td><td>Determine a cube selection of the desired area (selection) including **height** and **depth**. Specify the coordinates of two opposing corner blocks.</td></tr></tbody></table>

---

#### Edit or Remove a Gamemode Lock

<p class="callout info">Gamemode Locks can only be removed by players with the Admin Key (SWPM) who are located within the region/dimension Lock.</p>

`/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**

- Player has incorrect permissions to use the command
- Server has ranks that override or forbid the use of the command
- Player has incorrectly written the arguments (command)

**Cannot remove a Gamemode Lock**

- Not standing in a valid region with a gamemode lock to be deleted (none present, outside the region).

---

#### Changelog

<details id="bkmrk-this-is-not-a-comple"><summary>View Changes</summary>

<p class="callout info">This is not a complete list of version changes / fixes. It is a changelog of relevant wiki-related version information.</p>

<table border="1" style="border-collapse: collapse; width: 100%; height: 89.3907px;"><tbody><tr style="height: 29.7969px;"><td class="align-center" style="width: 13.3504%; height: 29.7969px;">**MC Version**</td><td class="align-center" style="width: 20.0257%; height: 29.7969px;">**Release**</td><td class="align-center" style="width: 66.6239%; height: 29.7969px;">**Notes**</td></tr><tr style="height: 29.7969px;"><td style="width: 13.3504%; height: 29.7969px;">1.18.2</td><td style="width: 20.0257%; height: 29.7969px;">1.18.2-2.1.0</td><td style="width: 66.6239%; height: 29.7969px;">New feature - added **/gamemode** command</td></tr></tbody></table>

</details>

# Commands/gamemode (HIDDEN)

Creates a game mod lock for a specific region or entire dimension.

<details id="bkmrk-contents-syntax-argu"><summary>Contents</summary>

1. [Syntax](#bkmrk-syntax)
2. [Arguments](#bkmrk-arguments)
3. [Result](#bkmrk-result)
4. [Examples](#bkmrk-examples)
5. [History](#bkmrk-history)

</details>### **Syntax**

---

<p class="callout info">All command should always begin with **/swpm**</p>

```Text
gamemode list
```

Lists the dimension game mode lock and any region locks, including a clickable text to teleport to the center of the region.

```
gamemode remove
gamemode remove dimension
```

Removes the region game mode lock you are standing in or the dimension wide game mode lock if *dimension* version is called.

```
gamemode <gamemode> <targets> dimension
gamemode <gamemode> <targets> <from> <to>
```

Adds a gamemode lock of the specified game mode, for the entity(s) either as dimension wide or region specific.

### **Arguments**

---

**&lt;gamemode&gt;**: [gamemode](https://minecraft.fandom.com/wiki/Argument_types#gamemode)   
Specifies the game mode of the game mode lock.  
Must be one of the following:

- - - **survival** for [Survival](https://minecraft.fandom.com/wiki/Survival) mode
        - **creative** for [Creative](https://minecraft.fandom.com/wiki/Creative) mode
        - **adventure** for [Adventure](https://minecraft.fandom.com/wiki/Adventure) mode
        - **spectator** for [Spectator](https://minecraft.fandom.com/wiki/Spectator) mode

Note that "[hardcore](https://minecraft.fandom.com/wiki/Hardcore)" is not a valid option, as it is technically not a game mode.

**&lt;targets&gt;**: [entity](https://minecraft.fandom.com/wiki/Argument_types#entity)  
Specifies the target(s) that should be locked to the game mode.  
Must be a player name, a [target selector](https://minecraft.fandom.com/wiki/Target_selector) or a [UUID](https://minecraft.fandom.com/wiki/UUID).

**&lt;from&gt;**: [block\_pos](https://minecraft.fandom.com/wiki/Argument_types#block_pos) and **&lt;to&gt;**: [block\_pos](https://minecraft.fandom.com/wiki/Argument_types#block_pos)  
Specifies any two opposing corner blocks of the region to be "gamemode locked".

### **Result**

---

<table border="1" id="bkmrk-command-trigger-resu" style="border-collapse: collapse; width: 100%; height: 178.781px;"><tbody><tr style="height: 29.7969px;"><td class="align-center" style="width: 33.3745%; height: 29.7969px;">Command</td><td class="align-center" style="width: 49.1965%; height: 29.7969px;">Trigger</td><td class="align-center" style="width: 17.4289%; height: 29.7969px;">Result</td></tr><tr style="height: 29.7969px;"><td style="width: 33.3745%; height: 29.7969px;">any</td><td style="width: 49.1965%; height: 29.7969px;">the arguments are not specified correctly</td><td style="width: 17.4289%; height: 29.7969px;">Unparseable</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px; width: 33.3745%;">/... remove  
</td><td style="width: 49.1965%; height: 29.7969px;">not standing in a region</td><td style="width: 17.4289%; height: 29.7969px;">Failed</td></tr><tr style="height: 29.7969px;"><td style="width: 33.3745%; height: 29.7969px;">any</td><td style="width: 49.1965%; height: 29.7969px;">Otherwise</td><td style="width: 17.4289%; height: 29.7969px;">Successful</td></tr></tbody></table>

### **Examples**

---

- **/swpm gamemode list**
    - Produces a list of regions that are currently defined.
- **/swpm gamemode remove dimension**  
    
    - Removes the dimension wide gamemode lock
- **/swpm gamemode ADVENTURE @a\[team=!admin\] dimension**  
    
    - Sets a dimension wide game mode lock, where all players that are NOT in the *admin* [team](https://minecraft.fandom.com/wiki/Commands/team) gets set to adventure mode. 
        - *Note: admin in this case is a user defined Minecraft team, and not something built into the mod*
- **/swpm gamemode CREATIVE @a ~20 ~20 ~20 ~-20 ~-20 ~-20**
    - Adds a region specific game mode lock, where all players inside the region gets set to creative game mode.
- **/swpm gamemode SURVIVAL @a\[team=!admin\] (dimension | &lt;from&gt; &lt;to&gt;)**
    - Set gamemode to survival to all but the admin team in either dimension or coords selection. (Must choose one and erase the other and also erase the parenthesis.

### **History**

---

<table border="1" id="bkmrk-java-edition-2.0.1-a" style="font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Oxygen, Ubuntu, Roboto, Cantarell, 'Fira Sans', 'Droid Sans', 'Helvetica Neue', sans-serif; font-size: 14px; width: 100%; height: 59.5938px;"><tbody><tr style="height: 29.7969px;"><td class="align-center" colspan="2" style="height: 29.7969px; width: 100.124%;">**Java Edition**</td></tr><tr style="height: 29.7969px;"><td class="align-center" style="width: 11.9137%; height: 29.7969px;">**2.1.0**</td><td style="width: 88.21%; height: 29.7969px;">Added **/gamemode** command</td></tr></tbody></table>

# Blacklist

Blacklisting can be setup by:

- Specifying item(s) in the `swpm-server.toml` config file (saves &gt; world &gt; serverconfig)
- Specifying items in game via commands

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

<p class="callout danger">Check and adjust the config prior to applying to or updating servers - blacklisted inventory items will be permanently lost.</p>

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).

<p class="callout warning">Blacklisted entities cannot be listed, added, or removed via commands. It is only possible through config.</p>

---

#### Exemption

All users are subject to blacklist item confiscation except for anyone with the [Blacklist Bypass key](https://wiki.swequestrian.com/books/swplus-mod/page/role-permission-keys#bkmrk-blacklist-bypass-key).

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

![image.png](https://wiki.swequestrian.com/uploads/images/gallery/2023-07/scaled-1680-/Cfqimage.png)

# 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](https://wiki.swequestrian.com/books/swplus-mod/page/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.

<p class="callout info">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.</p>

---

#### Thru

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

<p class="callout info">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.</p>

---

#### 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](https://wiki.swequestrian.com/uploads/images/gallery/2023-10/scaled-1680-/tDeimage.png)](https://wiki.swequestrian.com/uploads/images/gallery/2023-10/tDeimage.png)

[![image.png](https://wiki.swequestrian.com/uploads/images/gallery/2023-10/scaled-1680-/7Fzimage.png)](https://wiki.swequestrian.com/uploads/images/gallery/2023-10/7Fzimage.png)

<p class="callout info">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.</p>