Tweaks

A modern alternative to EssentialsX
bStat Metrics can be found here

Versions

Important

Version 3.0.0 introduces several breaking changes: command, permission, and translation incompatibilities.
It is highly recommended to delete the entire Tweaks folder before upgrading to avoid conflicts with outdated configurations.

Note

Tweaks only supports the latest version of Paper (1.21.1)
The latest version of Tweaks requires Java 21

Latest version supporting 1.19-1.20.4 (Java 19)
Latest version supporting 1.19-1.20.4 (Java 17)

Download

Modrinth
Hangar

What is New in the Latest Major Update

This release brings a host of exciting new features and enhancements:

New Commands & Features: Added commands for homes, spawn, tpa, warps, and a variety of new social commands.
Advanced Configurations:
- Feature Toggles: Every feature can now be enabled or disabled individually, giving you full control over your server’s functionality.
- Custom Links: Set up server links to your website or social media platforms.
- Teleportation Cooldowns: Teleportation now includes configurable cooldowns to balance gameplay.
- Conditional Spawn Teleportation: Decide when players should be teleported to spawn based on specific conditions.
GUI Customization:
- Icon Overrides: Customize the icons for your homes and warps GUIs to fit your server’s theme.
- Chat vs. GUI: Choose between using interactive GUIs or simple chat messages for warps and homes.
- Full GUI Customization: Modify the appearance and layout of GUIs to your liking.
Improved Command Flexibility:
- Command Customization: A new commands.json file allows you to rename commands and set up aliases effortlessly.
- Enchantment Overflow: You can now allow enchantment overflow up to level 255 in commands for even more control.
Performance Enhancements:
- Message Deletion Timeout: Configure a timeout for message deletion to prevent memory buildup from undeleted messages.

Commands

Environmental commands

Time commands

Command	Alternatives	Description	Permission
`/time add <time> [<world>]`		add N amount of ticks to the world time	tweaks.command.time.add
`/time query [day/daytime/gametime] [<world>]`		query the time of a world	tweaks.command.time.query
`/time set afternoon [<world>]`		set the time to afternoon (9000 ticks)	tweaks.command.time.afternoon
`/time set day [<world>]`	`/day [<world>]`	set the time to day (1000 ticks)	tweaks.command.time.day
`/time set midnight [<world>]`	`/midnight [<world>]`	set the time to midnight (18000 ticks)	tweaks.command.time.midnight
`/time set morning [<world>]`		set the time to morning (0 ticks)	tweaks.command.time.morning
`/time set night [<world>]`	`/night [<world>]`	set the time to night (13000 ticks)	tweaks.command.time.night
`/time set noon [<world>]`	`/noon [<world>]`	set the time to noon (6000 ticks)	tweaks.command.time.noon
`/time set sunrise [<world>]`		set the time to sunrise (23000 ticks)	tweaks.command.time.sunrise
`/time set sunset [<world>]`		set the time to sunset (12000 ticks)	tweaks.command.time.sunset

Weather commands

Command	Alternatives	Description	Permission
`/weather clear`	`/sun`	let the sun shine	tweaks.command.weather.sun
`/weather rain`	`/rain`	let it rain	tweaks.command.weather.rain
`/weather thunder`	`/thunder`	let it thunder	tweaks.command.weather.thunder

The perm-pack to grant all permissions: tweaks.commands.environmental

Home commands

Command	Aliases	Description	Permission
`/delete-home [<name>]`	`/delhome`	Delete your homes	tweaks.command.home.delete
`/home [<name>]`		Teleport you to your homes	tweaks.command.home
`/homes`		List all of your homes	tweaks.command.home
`/set-home [<name>]`	`/sethome`	Set a home	tweaks.command.home.set

Item commands

Command	Aliases	Description	Permission
`/enchant <enchantment> [<level>]`		enchant your tools	tweaks.command.enchant
`/head [player/url/value] [<value>]`	`/skull`	receive heads or information about them	tweaks.command.head
`/item [item] (amount)`	`/i`	gives you an item of your choice	tweaks.command.item
`/lore apped <text>`		append a line to the lore of your item	tweaks.command.lore
`/lore clear`		clear the lore of your item	tweaks.command.lore
`/lore prepend <text>`		prepend a line to the lore of your item	tweaks.command.lore
`/lore replace <text> <replacement>`		replace a specific string in the lore of your item	tweaks.command.lore
`/lore set <text>`		set the lore of your item	tweaks.command.lore
`/rename <name>`		change the displayname of your item	tweaks.command.rename
`/repair [all]`		repair your tools	tweaks.command.repair
`/unbreakable`		makes your item unbreakable	tweaks.command.unbreakable
`/unenchant <enchantment>`		unenchant your tools	tweaks.command.unenchant

The perm-pack to grant all permissions: tweaks.commands.item

MSG commands

Command	Aliases	Description	Permission
`/msg <player> <message>`	`/tell` `/write` `/t` `/w`	Send a private message to a player	tweaks.command.msg
`/msgtoggle`	`/togglemsg`	Toggle receiving private messages	tweaks.command.msg.toggle
`/reply <message>`	`/r`	Reply to the last received private message	tweaks.command.msg.reply

Player commands

Command	Aliases	Description	Permission	Argument	Permission
`/back`		go back to your last position	tweaks.command.back
`/enderchest [<player>]`	`/ec`	open your own or someone else's enderchest	tweaks.command.enderchest permits to use the command /enderchest to allow changes inside of an enderchest, grant tweaks.command.enderchest.edit	player	*.others
`/feed [<players>]`		satisfy your own or someone else's hunger	tweaks.command.feed	player	*.others
`/fly [<players>]`	`/flight`	toggle your own or someone else's fly state	tweaks.command.fly	player	*.others
`/gamemode [gamemode] [<player>]`	`/gm`	change your own or someone else's gamemode	tweaks.command.gamemode permits to use the command /gamemode	player	*.others
`/god [<targets>]`	`/invincible`	make you or someone else invulnerable	tweaks.command.god	player	*.others
`/hat`		equip your item as a hat	tweaks.command.hat
`/heal [<targets>]`		heal yourself or someone else	tweaks.command.heal	player	*.others
`/inventory [<player>]`	`/inv` `/invsee`	open your own or someone else's inventory	tweaks.command.inventory permits to use the command /inventory to allow changes inside of an inventory, grant tweaks.command.inventory.edit
`/offline-teleport <player> [<target>]`	`/offline-tp` `/tpo`	teleport offline-players to others or you to them	tweaks.command.offline-tp
`/ping [<player>]`	`/latency` `/ms`	see your own or someone else's latency	tweaks.command.ping	player	*.others
`/seen <player>`	`/find`	gives you information about a player	tweaks.command.seen
`/speed <speed> [fly/sneak/walk] [<targets>]`		Change your own or others fly, sneak or walk speed	tweaks.command.speed	targets	*.others
`/speed reset [fly/sneak/walk] [<targets>]`		Reset your own or others fly, sneak or walk speed	tweaks.command.speed	targets	*.others
`/suicide`		take your own life	tweaks.command.suicide
`/vanish (player)`	`/v` `/invisible`	hide yourself or someone else from others	tweaks.command.vanish

The perm-pack to grant all permissions: tweaks.commands.player

Server commands

Command	Aliases	Description	Permission
`/broadcast <message>`	`/bc`	Broadcast a message	tweaks.command.broadcast
`/lobby`	`/hub` `/l`	Connect to the lobby	tweaks.command.lobby
`/motd clear`		Reset the motd of the server	tweaks.command.motd
`/motd get`		Get the motd of the server	tweaks.command.motd
`/motd replace <text> <replacement>`		Replace a string in the motd of the server	tweaks.command.motd
`/motd set <motd>`		Change the motd of the server	tweaks.command.motd

The perm-pack to grant all permissions: tweaks.commands.server

Social commands

Command	Aliases	Description
`/discord`	`/dc`	Receive the server's Discord invite
`/reddit`		Receive the server's Subreddit link
`/teamspeak`	`/teamspeak3` `/ts` `/ts3`	Receive the server's TeamSpeak link
`/website`		Receive the server's Website url
`/x`	`/twitter`	Receive the server's X profile link
`/youtube`	`/yt`	Receive the server's YouTube channel link

Spawn commands

Command	Aliases	Description	Permission
`/set-spawn [<position>] [<yaw>] <pitch> [<world>]`	`/setspawn`	Set the spawn location	tweaks.command.setspawn
`/spawn`		Teleport you to spawn	tweaks.command.spawn

TPA commands

Command	Aliases	Description	Permission
`/tpa <player>`	`/tpask`	Request to teleport to a player	tweaks.command.tpa
`/tpaccept`		Accept a teleport request	tweaks.command.tpa.accept
`/tpadeny`	`/tpdeny`	Deny a teleport request	tweaks.command.tpa.deny
`/tpahere <player>`	`/tphere`	Request a player to teleport to you	tweaks.command.tpa.here
`/tpatoggle`	`/toggletpa`	Toggle the ability to receive teleport requests	tweaks.command.tpa.toggle

Warp commands

Command	Aliases	Description	Permission
`/delete-warp <warp>`	`/delwarp`	Delete a warp point	tweaks.command.warp.delete
`/set-warp <warp>`	`/setwarp`	Set a new warp point	tweaks.command.warp.set
`/warp <warp>`		Warp to a location	tweaks.command.warp
`/warps`		List all available warps	tweaks.command.warp

Workstation commands

Command	Aliases	Description	Permission
`/anvil`		Open a virtual anvil	tweaks.command.anvil
`/cartography-table`	`/cartography`	Open a virtual cartography table	tweaks.command.cartography-table
`/enchanting-table`	`/enchanting`	Open a virtual enchanting table	tweaks.command.enchanting-table
`/grindstone`		Open a virtual grindstone	tweaks.command.grindstone
`/loom`		Open a virtual loom	tweaks.command.loom
`/smithing-table`	`/smithing`	Open a virtual smithing table	tweaks.command.smithing-table
`/stonecutter`		Open a virtual stonecutter	tweaks.command.stonecutter
`/workbench`	`/wb`	Open a virtual workbench	tweaks.command.workbench

The perm-pack to grant all permissions: tweaks.commands.workstation

Chat Tags

These tags can be used within the chat-format of your translation files. To insert a tag, use <tag>.

Tag	Description
delete	A clickable component to delete the message.
display_name	The display name of the sender.
message	The original message sent by the player.
message_content	The text content of the sent message. Usable within click and hover actions.
player	The username of the sender.
world	The world where the sender is located.

Group and Display-Related Tags

These tags require a ServiceIO-compatible group/chat plugin, such as LuckPerms

Tag	Description
chat_display_name	Displays the player's display name. (not the same as `display_name`)
chat_prefix	The prefix of the sender.
chat_suffix	The suffix of the sender.
player_group	The group of the sender.
group_prefix	The prefix of the sender's group.
group_suffix	The suffix of the sender's group.

Economy-Related Tags

These tags require a ServiceIO-compatible economy plugin, such as Economist.

Tag	Description
balance	Displays the player's current balance, formatted according to the server's economy settings.
balance_unformatted	Displays the player's balance without any formatting (raw number).
bank_balance	Displays the player's bank account balance (if applicable), formatted as per the economy settings.
bank_balance_unformatted	Displays the player's bank account balance without formatting (raw number).
currency_name	Displays the singular form of the server's currency name (e.g., "Dollar", "Coin").
currency_name_plural	Displays the plural form of the currency name (e.g., "Dollars", "Coins").
currency_symbol	Displays the symbol of the currency (e.g., "$", "€").

For more information about MiniMessage, visit their Documentation

Chat Message Deletion

The delete-tag-format option allows you to customize the appearance of the message deletion component. For security purposes, only users with the permission tweaks.chat.delete will be able to see the delete tag. To allow users to delete their own messages, grant the permission: tweaks.chat.delete.own.

Hierarchy

This feature requires ServiceIO and a compatible permission plugin such as LuckPerms.

The chat hierarchy system controls who can delete whose messages based on a user's weight. A user's weight determines their deletion privileges. Users can only delete messages from others with equal or lower weights.

Example

Admin: deletion weight 99 Admins can delete messages from Admins, Moderators, and Players.
Moderator: deletion weight 50 Moderators can delete messages from Moderators and Players but not Admins.
Player: deletion weight undefined Players can't delete messages from anyone.

Setting Weights in LuckPerms:

To assign a hierarchy weight in LuckPerms, use the following permission: meta.chat-delete-weight.<weight>

Alternatively, you can use the command: /lp user <player> meta set chat-delete-weight <weight>

Configuration

General Configuration

Option	Description
`message-deletion-timeout`	Time in milliseconds chat messages may be deleted for.
`back-buffer-stack-size`	How many back-locations should be stored per user.
`default-permission-level`	Clientside permission level assigned to users. (1-4)
`enchantment-overflow`	Enables or disables enchantment overflow.
`override-join-message`	Whether join messages should be overridden.
`override-quit-message`	Whether quit messages should be overridden.
`override-chat`	Whether tweaks should override the chat.
`log-chat`	Whether the chat should be logged to console.
`lobby-server-name`	Name of the lobby server (for `/lobby`).
`motd`	Message of the day for the server.

Features Configuration

Option	Description
`homes`	Enables or disables the homes feature.
`msg`	Enables or disables the private message feature.
`spawn`	Enables or disables the spawn feature.
`tpa`	Enables or disables the teleport request feature.
`warps`	Enables or disables the warps feature.
`lobby`	Enables or disables the lobby feature. (Right mode should be detected)

Features Social Configuration

Option	Description
`add-link-commands`	Enable link commands like `/discord`, `/reddit` etc.
`add-server-links`	Whether to add the links to the `Server Links` tab.
`announcements`	Enables the announcements feature.
`community`	Enables the community feature.
`feedback`	Enables the feedback feature.
`forum`	Enables the forum feature.
`guidelines`	Enables the guidelines feature.
`issues`	Enables the issues feature.
`news`	Enables the news feature.
`status`	Enables the status feature.
`support`	Enables the support feature.
`website`	Enables the website feature.
`discord`	Enables the Discord link command.
`reddit`	Enables the Reddit link command.
`teamspeak`	Enables the TeamSpeak link command.
`twitch`	Enables the Twitch link command.
`x`	Enables the X (Twitter) link command.
`youtube`	Enables the YouTube link command.

Home Configuration

Option	Description
`limit`	Maximum number of homes allowed (negative value indicates unlimited).
`unnamed-name`	Default name for unnamed homes.

Spawn Configuration

Option	Description
`teleport-on-first-join`	Teleports player to spawn on first join.
`teleport-on-join`	Teleports player to spawn on join.
`teleport-on-respawn`	Teleports player to spawn on respawn.
`ignore-respawn-position`	Ignores the exact respawn position.
`location`	Spawn location (in `world, x, y, z, yaw, pitch` format).

GUI Configuration

Inventory GUI

Option	Description
`helmet`	Material for the helmet placeholder slot in GUI.
`chestplate`	Material for the chestplate placeholder slot in GUI.
`leggings`	Material for the leggings placeholder slot in GUI.
`boots`	Material for the boots placeholder slot in GUI.
`off-hand`	Material for the off-hand placeholder slot in GUI.
`cursor`	Material for the cursor placeholder slot in GUI.
`placeholder`	Material for placeholder slots in GUI.
`update-time`	Update time for the inventory GUI in ticks. (1s = 20)

Homes GUI

Option	Description
`enabled`	Enables or disables the homes GUI. (chat based if disabled)
`rows`	Number of rows in the homes GUI.
`action-slots`	Slots in the homes GUI that may contain homes.
`button-slot-next`	Slot for the next button in the homes GUI.
`button-slot-previous`	Slot for the previous button in the homes GUI.

Warps GUI

Option	Description
`enabled`	Enables or disables the warps GUI. (chat base if disabled)
`rows`	Number of rows in the warps GUI.
`action-slots`	Slots in the warps GUI that may contain warps.
`button-slot-next`	Slot for the next button in the warps GUI.
`button-slot-previous`	Slot for the previous button in the warps GUI.

Name Icons

Option	Description
`name-icons`	Icons for named locations.

Example

{
  "name-icons": {
    "End Ship": "minecraft:elytra",
    "Bastion": "minecraft:polished_blackstone_bricks",
    "Mine": "minecraft:diamond",
    "Casino": "minecraft:gold_ingot"
  }
}

Teleport Configuration

Option	Description
`cooldown`	Cooldown time in milliseconds for teleportation.
`cooldown-allow-movement`	Allows movement during teleport cooldown.
`tpa-timeout`	Timeout duration in milliseconds for teleport requests.

Animals Configuration

Option	Description
`cow-milking-cooldown`	Cooldown time in milliseconds for cow milking.
`mushroom-stew-cooldown`	Cooldown time in milliseconds for getting mushroom stew from a mooshroom.
`sheep-wool-growth-cooldown`	Cooldown time in milliseconds before sheep can grow back their wool.
`animal-heal-by-feeding`	Enables or disables animal healing by feeding them.

Links Configuration

Option	Description
`announcements`	URL for announcements.
`community`	URL for community.
`feedback`	URL for feedback.
`forum`	URL for the forum.
`guidelines`	URL for guidelines.
`issues`	URL for issues tracking.
`news`	URL for the news page.
`status`	URL for the status page.
`support`	URL for the support page.
`website`	URL for the main website.
`discord`	URL for the Discord server invitation.
`reddit`	URL for the subreddit.
`teamspeak`	URL for the TeamSpeak server.
`twitch`	URL for the Twitch channel.
`x`	URL for the X (Twitter) profile.
`youtube`	URL for the YouTube channel.

Commands file

{
  "hello": {
    // the key can't be changed
    "command": "test",
    // can be named whatever you want
    "aliases": [
      "test-1",
      // can contain as many aliases you want
      ""
      // can even be empty to work on '/' 
    ],
  },
  "nope": {
    "command": "nope",
    "aliases": []
    // can be empty, to not register any aliases
  }
}

Files

README.md

Latest commit

History

README.md

File metadata and controls

Tweaks

Versions

Download

What is New in the Latest Major Update

Commands

Environmental commands

Time commands

Weather commands

Home commands

Item commands

MSG commands

Player commands

Server commands

Social commands

Spawn commands

TPA commands

Warp commands

Workstation commands

Chat Tags

Group and Display-Related Tags

Economy-Related Tags

Chat Message Deletion

Hierarchy

Example

Setting Weights in LuckPerms:

Configuration

General Configuration

Features Configuration

Features Social Configuration

Home Configuration

Spawn Configuration

GUI Configuration

Inventory GUI

Homes GUI

Warps GUI

Name Icons

Example

Teleport Configuration

Animals Configuration

Links Configuration

Commands file