Swap Things - a forge mod

Mod mainly created to work with Twitch Integration mods (like CCI and TwitchSpawn). Adds commands for viewers to interact and make things more entertaining for the streamer.

Currently there are twenty eight commands.

Commands:

Command notes:

Arguments in <> mean they are required while [] are optional.
All playername arguments are optional. If not given will use who/what ran the command.
Any commands with two players will attempt to get a different second playername than the first unless it isn't randomly chosen. However it will only attempt to get a different one 10 * currently only players number of times. If the player name is still the same will use as is.
All commands can be used regardless of if there is only one player on or several. Although, swaparmor and swaplocation commands will not show a visible difference other than a message in chat.

DisconnectPlayer

/swapthings disconnectplayer [playername] [courtesy of]
		
Disconnects the given player from the world or server

Message on disconnect is controlled by the config value

DisplayDeathBoard

/swapthings displaydeathboard
		
Gets death count from the player Stats and list them in chat

Message next to each name is controlled by the config value
If one value is given will use it for all places. If there is at least two values separated by a comma will put messages in order

HeldEnchanting

/swapthings heldenchanting [playername] [courtesy of] [enchantment] [enchantment_level]
		
Adds/removes/updates held item with a given enchantment or random if none is given

If an enchantment is not given will choose a random valid enchantment and level
If an enchantment level is not given will choose a random valid one for the given enchantment (0 is possible which will remove the enchantment
When specifying the enchantment level can do higher than usual (i.e. minecraft:efficiency 10 will give Efficiency X)

InventoryBomb

/swapthings inventorybomb [playername] [courtesy of]
		
Drops and replaces all inventory items with the item specified in the config

Default item is minecraft:dead_bush or if config value is invalid
Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.

InventoryEqualizer

/swapthings inventoryequalizer [playername] [item] [stack amount] [courtesy of]
		
Drops and replaces all inventory items with the item specified with each stack having the same amount

Default item is minecraft:dead_bush and a stack size of 1/li>
Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.

InventorySlotClearer

/swapthings inventoryslotclearer [playername] [amount] [courtesy of]
		
Clears a specific inventory slot based on the decimal place of the amount or random if not given one.

Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.
Amount ignores the whole number amount and only looks for decimal places.
1. .00 is held item
2. .01 - .09 is hotbar
3. .10 - .18 is top line in inventory
4. .19 - .27 is second line in inventory
5. .28 - .36 is third line in inventory
6. .37 is boots
7. .38 is leggings
8. .39 is chestplate
9. .40 is helmet
10. .41 is offhand
11. .42 and above is outside of the default player's inventory size

InventorySlotEnchanting

/swapthings inventoryslotenchanting [playername] [amount] [courtesy of] [enchantment] [enchantment_level]
		
Enchants a specific inventory slot based on the decimal place of the amount or random if not given one.

If an enchantment is not given will choose a random valid enchantment and level
If an enchantment level is not given will choose a random valid one for the given enchantment (0 is possible which will remove the enchantment
When specifying the enchantment level can do higher than usual (i.e. minecraft:efficiency 10 will give Efficiency X)
Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.
Amount ignores the whole number amount and only looks for decimal places.
1. .00 is held item
2. .01 - .09 is hotbar
3. .10 - .18 is top line in inventory
4. .19 - .27 is second line in inventory
5. .28 - .36 is third line in inventory
6. .37 is boots
7. .38 is leggings
8. .39 is chestplate
9. .40 is helmet
10. .41 is offhand
11. .42 and above is outside of the default player's inventory size

InventorySlotRenamer

/swapthings inventoryslotrenamer [playername] [courtesy of] [amount]
		
Renames an inventory item to have the prefix of "[courtesy of]'s "

If an amount is not given it will try to find a non empty inventory slot and use that
Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.
Amount ignores the whole number amount and only looks for decimal places.
1. .00 is held item
2. .01 - .09 is hotbar
3. .10 - .18 is top line in inventory
4. .19 - .27 is second line in inventory
5. .28 - .36 is third line in inventory
6. .37 is boots
7. .38 is leggings
8. .39 is chestplate
9. .40 is helmet
10. .41 is offhand
11. .42 and above is outside of the default player's inventory size

InventorySlotReplacer

/swapthings inventoryslotreplacer [player] [item] [slot num] [courtesy of]
		
Drops and replaces an inventory slot with the given item

If an item is not given it will default to Air/empty slot
If a slot num is not given it will try to find a non empty inventory slot and use that
Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.
-1 slot number will make it do random else it does the following
1. 0 is held item
2. 1 - 9 is hotbar
3. 10 - 18 is top line in inventory
4. 19 - 27 is second line in inventory
5. 28 - 36 is third line in inventory
6. 37 is boots
7. 38 is leggings
8. 39 is chestplate
9. 40 is helmet
10. 41 is offhand
11. 42 and above is outside of the default player's inventory size and will loop back around to force it within the inventory size

InventorySlotUnnamer

/swapthings inventoryslotunnamer [playername] [courtesy of] [amount]
		
Unnames an inventory item back to the default name"

If an amount is not given it will try to find a non empty inventory slot and use that
Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.
Amount ignores the whole number amount and only looks for decimal places.
1. .00 is held item
2. .01 - .09 is hotbar
3. .10 - .18 is top line in inventory
4. .19 - .27 is second line in inventory
5. .28 - .36 is third line in inventory
6. .37 is boots
7. .38 is leggings
8. .39 is chestplate
9. .40 is helmet
10. .41 is offhand
11. .42 and above is outside of the default player's inventory size

PlayerNudger

/swapthings playernudger [playername] [courtesy of]
		
Nudges the player in a random direction.

Direction chances are based on the config chance values
Strength is also in the config and default to .7 which will push the player one block in that direction
Multiplier config values will times the normal direction chance by the multiplier based on what direction the player is facing. A 0 for either the Chance or Multiplier will never nudge that direction and a 1 is default.

PlayerRotate

/swapthings playerrotate [playername] [courtesy of]
		
Forces the player to look at a random direction.

QuickHide

/swapthings quickhide [playername] [<item> <message>] 
		
Throws the four basic armor slots, offhand, and held item onto the ground. Then replaces all of those slots with the item given or if none given a random one in the below list and displays a message to all players on server.

If want do your own item and message playername is required
Currently these are the choices it will choose from at random (will change into a config in future)
1. minecraft:deadbush, quick hide in these bushes!
2. minecraft:wheat, quick hide in the wheat field!
3. minecraft:feather, quick act like a chicken!
4. minecraft:painting, quick blend into the wall!

RandomGift

/swapthings randomgift [playername] [courtesy of]
		
Gifts a random item based on the list in the configs

Each list item contains three parts.
1. Item name/ Namespaced ID - i.e. minecraft:stone_button
2. Stack amount - Any number 1-64
3. Weighted chance number - if put 5 it means it will have five chances of choosing this item
If want an equal chance of choosing can put the weighted chance number as 1 for all

RandomTeleport

/swapthings randomteleport [playername] [courtesy of]
		
Teleports the player to a random location based on config min/max values for each axis.

/swapthings randomteleport [playername] [courtesy of] [X_Min] [X_Max] [Y_Min] [Y_Max] [Z_Min] [Z_Max]
		
Teleports the player to a random location based on given numbers instead of the config min/max values for each axis.

Direction chances are based on the config chance values

RandomTeleportDistance

/swapthings randomteleportdirection [playername] [courtesy of] [distance]
		
Teleports user in a random direction with the given amount as distance from their original spot.

Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.
If no distance is given will use the config value

ReplaceArmorPiece

/swapthings replacearmorpiece [playername] [head|chest|legs|feet|mainhand|offhand|random] [item] [courtesy of]
		
Drops and replaces armor in the given slot with the given item

RANDOM will choose a random single option (helm, chest, legs, boots, mainhand, or offhand) from the list.
If no item is given it defaults to a dead bush

ShuffleHotbar

/swapthings shufflehotbar [playername] [courtesy of]
		
Goes through all of the hotbar slots and randomly swaps it with another hotbar slot.

Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.

ShuffleInventory

/swapthings shuffleinventory [playername] [courtesy of]
		
Goes through all of the hotbar, equipment, and inventory slots and randomly swaps it with another slot.

Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.

ShuffleInventoryNames

/swapthings shuffleinventorynames [playername] [courtesy of]
		
Goes through all of the hotbar, equipment, and inventory slots and randomly swaps the item names with another slot.

Courtesy of is an optional text string. If nothing is given will just shuffle item names around.
If Courtesy of is given it will prefix all shuffled item names with what is given plus 's

SummonMount

/swapthings summonmount [playername] [courtesy of] [mount]
		
Summons a random Entity and makes the player ride it.

Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.
If a mount is specified in the command it will always choose it instead of doing a random one

SummonRider

/swapthings summonrider [playername] [courtesy of]
		
Summons a random Entity and makes it ride the player.

Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.
Some cases may need to use the UnMounter command or a death to remove it.

SwapArmor

/swapthings swaparmor <head|chest|legs|feet|mainhand|offhand|all|set|random> [playername] [playername]
		
Based on the option given will swap armor with another player.

ALL will swap all six of the options before it (four basic armor, mainhand, and offhand) at once.
SET will swap all of the four basic armor slots.
RANDOM will choose a random single option (helm, chest, legs, boots, mainhand, or offhand) from the list.
1. RANDOM is likely to choose different slots for the two players. It prefers non empty slots but it is possible to switch boots with a helm this way.

SwapHands

/swapthings swaphands [playername] [courtesy of]
		
Swaps the held and offhand items of the given player

Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.

SwapIdentity

/swapthings swapidentity [playername] [playername]
		
Swaps the location, inventory, and experience of the two players with each other and drops any helmets equipped, and equips the skull of the other player.

Players will also be set to look in the direction the other person was looking

SwapInventoryNames

/swapthings swapinventorynames [playername] [courtesy of]
		
Goes through all of the hotbar, equipment, and inventory slots and randomly replaces the name with another player's item name or a random item name.

Courtesy of is an optional text string. If nothing is given will just shuffle item names around.
If Courtesy of is given it will prefix all shuffled item names with what is given plus 's

SwapLocation

/swapthings swaplocation [playername] [playername]
		
Swaps the location of the two players with each other.

Players will also be set to look in the direction the other person was looking

ToggleCrouch

/swapthings togglecrouch [playername] [courtesy of]
		
Toggles if the player is crouching until command is run again, player presses their crouch key, or opens chat.

Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.

ToggleRun

/swapthings togglerun [playername] [courtesy of]
		
Toggles if the player is running until command is run again, player presses their sprint key, or stops.

Courtesy of is an optional text string if want the message displayed in chat to have a username in it. If none is given will just use "someone" instead.

UnMounter

/swapthings unmounter [playername] [courtesy of]
		
Unmounts whatever the player is riding on or that is riding on the player

UnshuffleInventoryNames

/swapthings unshuffleinventorynames [playername] [courtesy of]
		
Goes through all of the inventory slots and removes all custom names

SwapThings