Henny Essentials

Henny Essentials V1.0.4-E3

Changes in this version:

Conditions

• You can now define conditions in config/HennyEssentials/Conditions.json
• Conditions can be used to run commands when a player performs a certain action (eg: block break, reaches X playtime)
  • This can be used to auto rank-up players that reach a certain playtime
• Currently only "playtime" type is supported but more will be added in the future.
• With "playtime" type, triggerValue is the number of seconds a player has to have played before being granted this reward.
• TODO: repeatable boolean
• The commands support %p placeholder for playername

Condition Commands

• /he condition unredeem playername conditionID ~ if a player has already recieved this reward, remove the marker from their player data so they can receive the reward again.
• /he condition manualredeem playername conditionID ~ manually run the condition rewards for a player
• /he condition reloadconfig ~ self explanatory

Condition Examples

• Example Conditions.json with one condition that runs when a player reaches 5 minutes playtime:

{
  "conditions": [
    {
      "type": "playtime",
      "triggerValue": 300.0,
      "commands": [
        "say hi %p!",
        "give %p minecraft:diamond"
      ],
      "conditionID": "admin-rank"
    }
  ]
}

• To add more conditions, just separate the objects with a comma like so:

{
  "conditions": [
    {
      "type": "playtime",
      "triggerValue": 300.0,
      "commands": [
        "say %p has played for 5 minutes!",
        "give %p minecraft:diamond"
      ],
      "conditionID": "starter-rank"
    },
    {
      "type": "playtime",
      "triggerValue": 600.0,
      "commands": [
        "say %p has played for 10 minutes!",
        "give %p minecraft:diamond 2"
      ],
      "conditionID": "novice-rank"
    }
  ]
}

Pages

• New file in config folder called Pages.json
• Users can define custom pages with text
• Players can access these pages in game with the command /he page
• TODO: permissions

Banned Item Bypass permissions

• You can now give users/groups the permission he.banneditem.bypass.modname:item_id to allow them to use the defined banned item.
  • Example: he.banneditem.bypass.minecraft:ender_chest

AFK Command

• Added /he afk to manually set your status to AFK

Permissions

• You can now set up HE permissions more easily by using the permission groups
  • Users with permission he.user will have access to most user commands including:
    • /he sethome
    • /he home
    • /he warps
    • /he kits
    • /he tpa / tpaaccept / tpadeny
  • Users with permission he.admin will have access to most admin commands including:
    • /he ban
    • /he mute
    • /he setwarp
    • /he createkit
    • /he editkit
    • /he viewechest
    • /he fly, heal, vanish, feed
  • All permission commands
• These permission groups work both with and without LP integration enabled.
• If you have feedback on more commands that should be included in either user/admin groups, please let me know on Discord.

Utility commands

• Added /he anvil ~ Opens anvil
• Added /he ctable ~ Opens crafting table
• Added /he smithtable ~ Opens smithing table
• Added /he stonecutter ~ opens stoncutter
• Added /he hat ~ sets players held item as their hat

More vanish fixes

• Fixed a bug where changing worlds while in vanish removed your skin until server restart

Playtime

• HE will now track each players playtime /he playtime
• Option in config to enable/disable counting AFK time as playtime

Permissions

• The way HE behaves when LuckPerms integration is enabled has been changed.
• When using LP integration, players should use lp verbose on to check what permission nodes to use for commands.
• When not using LP integration, players should use he permission verbose to check what permission nodes to use for commands.
  • Example HE permission: command.he.permission.user.add
  • Example LP permission: command.he.adduserperm
• Fixed dimension permission denied teleport to use correct look angles
• Added new PermissionConfig: shouldIncludeArgumentNodesInPermissions - this will add nodes to command arguments in HE Permissions. This won't do anything if LP integration is enabled.
  • Example: The enchant command HE permission is command.enchant
  • With shouldIncludeArgumentNodesInPermissions set to true, the full permission would be command.enchant.targets.enchantment.level
  • If a player only has permission command.enchant.targets.enchantment, they cannot set a level and the command will default to level 1.
  • This gives further customisation on which commands and which arguments players can use.

Chat Colors

• HE now supports chat colors if chat formatting and chat colors enabled in config.
• Color code symbol can be changed in config. Default is: &
• If permissions enabled AND permissionCheckForChatColors enabled, you need the following permissions:
  • he.chat.format.COLORNAME
  • You can find the list of colors HERE
  • For example, to give a player access to all formats you would give permission he.format.*
  • To give a player access to only dark gray text you would give permission he.format.dark_gray
    
    

Command Aliases

• You can now define a list of aliases for a command, instead of just one alias for one command.
• Your aliasMap in config will be automatically migrated to an aliasList where you can then add more aliases.
• Example:

  "aliasConfigs": {
    "aliasList": {
      "he kits": [
        "kits",
        "listkits",
        "kitlist"
      ]
    }
  }

Command Tokens

• CommandTokens now have an optional reusableUsageLimit.
  • if the token is reusable, it will disappear on its final use
• CommandTokens can now have a "permission" string added to their config entry and if permissions are enabled, only players with the defined permission can use the token.
• CommandTokens now have a shouldWriteToAuditLog option to determine whether to log usages of that token to Audit Log
  • Must have shouldWriteCommandTokenUsagesToAuditLog set to true to work.
    
    

Back command

• There is now a config option to make the /he back command save your last teleport location as well as last death location.
• The teleports it will register are teleports done by HE mod. Actions such as nether portals and ender pearls will not count.
  
  

Kit and Warp names are now stored as lowercase

• ^^^ All previously saved kits and warps will be converted. No manual action required.

Fixes

• Fixed TPA command not sending confirmation that request was sent
• Fixed TPA command not sending confirmation that you had accepted/denied a request
• Fixed being able to accept/deny a single TPA request multiple times

Alias + Permission fixes

• Fixed command aliases not inheriting the correct permissions.
• All command alias should now require the correct permission to execute the command.
• HE Perms: check with he permission verbose
• LP Perms: check with lp verbose on

Permission fixes

• Fixed permission requirement for /home when no home name was given. Now has the correct permission: command.he.home

Vanish / Fly check task fixes

• Better checking of vanish/fly and removing if no permission