Tweaks

An EssentialsX-like plugin

Versions

[!WARNING] There is a known issue when updating from version 3.0.x to 3.1.0 or upcoming, all commands will be disabled. This won't be fixed soon because it is of low priority and only happens when updating. After updating, you can fix this by replacing all enabled: false with enabled: true in commands.json

[!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 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 now

Commands

Environmental commands

Time commands

Weather commands

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

Home commands

Item commands

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

MSG commands

Player commands

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

Server commands

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

Social commands

Spawn commands

TPA commands

Warp commands

Workstation commands

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

Group and Display-Related Tags

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

Economy-Related Tags

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

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

Features Configuration

Features Social Configuration

Home Configuration

Spawn Configuration

GUI Configuration

Inventory GUI

Homes GUI

Warps GUI

Name Icons

Example

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

Teleport Configuration

The permission to bypass the teleportation cooldown is tweaks.teleport.cooldown.bypass

Animals Configuration

Links Configuration

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