PlayerDoll

Changelog:

• Rebuild the plugin

Patch note:

• Bump Version to 2.4
• Support 1.21.5 Spigot and Paper (experimental build)

Note:

• Folia 1.21.5 is not yet released

• Addons are available below this changelog, put them into plugins/PlayerDoll/addon/

• Besides the Main Plugin jar, addon-Wrapper & addon-Doll (& Addon-Folia for Folia servers), are necessary for core functionalities

• If you are using 1.20.6+ Paper and its downstream, please download correct addons that indicates Mojang Mapping (X-Mojang.jar)

• If you are using Spigot, please download Spigot Mapping (X-Spigot.jar)

Updated jar

• Main
• Addon-Wrapper-1215 (1.21.5)
• Addon-Doll-v1_21_R4-1215 (1.21.5)

Patch note:

• Fixed an issue that Doll cannot connect server while whitelist has enabled

Updated jar

• Main

Patch Note:

• Fixed Doll connections problem for certain versions
• Fixed Doll cannot inherit permission from permission plugins
• Added empty string check for config key doll-permission
• Added config key doll-metadata for Doll for special usage

Note:

• Main & All Addon-Doll are updated
• Config version is now 32

Patch Note:

• Fixed version checking v2.1 (shou692199)
• Renamed Addon to enhance version readability (shou692199)
• Fixed some GUI pages did not display previous page by clicking outside (backpack, gset, set)
• Optimized & Advanced Exp command
• Moved Skin Permission before text extern/local
• Delayed Doll teleport when Spawn, avoid Doll not teleporting in certain condition
• Removed redundant OP permission while Doll spawn
• Fixed ConvertPlayer cannot inherit permission from permission plugin
• Delayed AsyncPlayerPreLoginEvent when Doll Login to avoid permission plugin Kick
• Fixed certain text not applying newline

Exp command

Improved performance while calculating experience.

Added integer overflow check

New argument asOrb for EXP command:

• Experience will be given as experience Orb
• Useful for mending

Changed Click interaction for GUI EXP:

• Left click -> get Exp conventionally
• Right click -> get Exp as EXP Orb
• Shift click -> get All levels (within integer limit)
• Non-shift click -> get 1 level

Updated description for GUI Exp icon

Addons

• Simplied Mapping string to Mojang or Spigot
• Added trailing string for Minecraft version support(i.e. 1210_1211 -> 1.21.0 to 1.21.1)

Note:

• Config Version is now 31
• Main & Addon-Doll has been updated
• Renamed Addon-Wrapper

Patch Note:

• Disabled Dev message in startup
• Supported 1.21.4 Spigot
• Added LookAt action command
• Updated Create command arguments for skin fetching
• Added raw message for Version command
• Fixed Doll don't follow default prefix & suffix in perm.yml when Doll owner is not online (works even if perm.yml has disabled)

Skin Fetching

new literal nodes are added to the Create command.

/doll create <name> [extern|local <skin>]

extern: Fetch player skin online local: Fetch player skin from local server

Note:

• config version is now 30
• Addon-Folia has renamed (discarded version)
• Wrapper Addon for 1.21.2+ is still Addon-Wrapper-1212 (will be renamed if there is breaking change)

Addon updated:

• All Addon-Doll
• new Addon for 1.21.4 (Addon-Doll-v1_21_R3)

For Addon-Wrapper, please download from the previous version

Patch Note [Dev]:

• Fix Paper NoSuchMethodError getBukkitEntity() (shou692199)

Addon updated:

• v1_20_R2
• v1_20_R3
• v1_20_R4
• v1_21_R1
• v1_21_R2

Patch Note [Dev]:

• Fixed a Crash NoSuchMethodError in Folia when Doll spawn.Related addons (Addon-Doll) are updated

Patch Note [Dev]:

• Reworked code base for API and Extension compability (Early Access)
• Support Game 1.21.2 1.21.3 (using Addon)
• Ported old Game version support to Addon
• Improved config loading
• Doll connection thread is now blocking while server shutdown again for safety
• Fixed right-clicking Doll Inventory GUI cannot set slot
• Fixed error in Drop command
• Rework custom GUI and Removed improper use of extending InventoryHolder
• Added perTick argument for action commands
• Added version subcommand for version checking
• Supported paging for Doll setting, pset and gset
• Lookat Action is temporarily unavailable in this version
• Stop supporting BungeeCord
• Adjusted some config keys

API & Extension

To reduce the plugin file-size impact of NMS version and to adapt the new update cycle from Mojang. Addon is introduced for server owners to customize the addon installation in needs (mostly for NMS).

• Create subcommands in /doll
• Custom implementation of Doll
• Create Buttons for setting / gset / pset
• Custom Game Version support
• Others

At now, the API is still not perfect, and not encouraged to use it as custom development.

Required Addons:

1. Doll-<Version>-<Mapping>.jar
2. Wrapper-<Version>-<Mapping>.jar

*Spigot branch

Download Doll and Wrapper (Spigot-Mapping) by version

*PaperSeries & Folia branch

• Server in 1.20.2 - 1.20.4 Download Doll and Wrapper (Spigot-Mapping) by version

• Server in 1.20.5 or above Download Doll and Wrapper (Mojang-Mapping) by version

*Folia branch

Download Addon-Folia.jar additionally

Note: Some Addons are crucial for this plugin in order to provide complete functionalities. The provided addons are default behavior as previuos versions.

All addons are stored in plugins/PlayerDoll/addon/

perTick argument

A new argument is added for actions.

Doll / Converted players are able to perform action up to 40 times in each tick.

Example: /doll attack abc perTick 20

Doll "abc" will try to destroy(attack) blocks 20 times in 1 gametick

Note: perTick may affect server performance if set too high. Please use it carefully.

Others

• Config version is now 29
• Bugs or malfunctions might occur after reworking of code

Patch Note:

• Doll connection thread is no longer blocking while server shutdown
• Fixed Doll cannot perform use command to interact to world
• Trying to fix teleport packet crash on Folia
• Fixed some exploits in remove command
• Fixed incorrect Doll fetching in spawn command

Teleport Packet Crash

It is known that in Folia, some servers might facing random crash due to Doll's teleport packet handling.

If you share the same problem, please reply to Github Discussion

Patch Note:

• Supported Non-player command input (some still require player)
• Fixed Doll cannot tick certain vehicles while mounting
• Fixed the argument all in Exp command can only get 1 level
• Fixed an issue that sometimes error was thrown during Use command

Patch Note:

• Fixed sometimes Doll cannot be spawn due to the method from resource pack packet is located wrongly if resource pack is enabled

Patch Note:

• Fixed spelling mistakes in resource pack class, causing Doll stuck in login process if the server has resource pack enabled

Patch Note:

• Fixed plugin cannot recognize 1.21.1

Patch Note:

• all patches in v1.35
• Fixed doll connection did not handle respawn correctly

Patch Note [Dev]:

• Changed Doll connection from Socket to Netty, become more performant
• Changed packet to NMS, should be more resilient to packet change
• Should fix some connection bugs
• Changed Tracer class (NMS to plugin API)
• Changed related logics in Actionpack class (tracer)
• Supported 1.21 Folia Dev

Known issues:

• Bottom parts of Doll real inv are shifted, causing interaction to Doll's armor and offhand slot (Bug from plugin API)

Note:

• This is a Dev version, please use it carefully.
• Please report any problems when you have any difficulties

Patch Note:

• Setup Github Wiki for detailed information
• Improved Shift actions in Doll Inv GUI
• Fixed Doll Inv GUI causing item to disappear by certain interaction
• Added spam preventation for Doll Inv GUI (4ticks)
• Fixed Dropping Item through GUI in Folia server causes error
• Changed config key proxy-auto-join-delay to auto-join-delay
• Prevent plugin disable while Doll auto-join
• Removed grouped permission in plugin.yml
• Added wildcards for permissions in plugin.yml
• Fixed Doll auto-join not applying Doll Identifier
• Fixed an issue that when player attempts to pset a newly set player, flag did not set

Doll Inv GUI

In this version, shift actions in Inv do stack similar items together (not in old versions)

auto-join-delay

Now it will also work on non-BungeeCord connections

Wildcards for permissions

• playerdoll.command.* -> Wildcard for command
• playerdoll.globalflag.* -> Wildcard for global flag
• playerdoll.personalflag.* -> Wildcard for personal flag

Others

• Config version is now 28
• Grouped permission is no longer be used, please re-configure those permissions if you are using it

Patch Note:

• Fixed player cannot perform PlayerDoll commands outside chat

Patch Note (Beta):

• A relatively complex update is released, not all functions are well tested.

New Features

• Supported 1.20.2
• Added Config key force-proxy-ip
• Added Config key doll-identifier

Changes / Bug Fixes

• Improved packet processing
• Fixed Doll not dismount from Entity when Die / Disconnect
• Fixed Doll cannot Join server if server.properties has required resource pack set
• Fixed Doll join-at-start not working
• Updated command system for configurable Doll identifier
• Updated Doll config system for configurable Doll identifier
• Added comments for serveral Config keys
• Adjusted Config key server-max-doll to server-max-doll-spawn

Known Issues

• Doll cannot update Boat while mounting
• Doll cannot be push by piston with Slime block correctly
• Doll causes Crash in Folia servers when Map is tracking Regions containing Doll (Temporary Solution below)

Packet Processing

A new packet logic is used Basic operations are fine Please write issue if any problems found

Force Proxy Ip

default: false A optional tweak should fix Doll not joining server while the default connection address is not working

Doll Identifier

default: "-" The identifier that Doll spawns with Can be empty or 1 character Should avoid common character that is username available or being used by other plugins

Note: Some characters will cause confusion to Vanilla / Other Plugin Commands.

Set to '' for disabling identifier

BungeeCord

Updated corrisponding logic to adapt configurable Doll identifier

Notes

Doll config has updated, and the format has changed because of the configurable identifier. Please let Doll owners to cleanup all Doll data before updating to this version It is not encouraged to keep old configs, weird problems might occurr.

Suggested Upgrade Flow:

1. Cleanup Doll data
2. Remove all Doll configs in plugins/doll and in dat file world/playerdata
3. Update plugin
4. Create new Doll

Temporary Solution to fix Crash in Folia Servers:

Goto paper-world-defaults.yml and change the value of item-frame-cursor-update-interval to 0

Patch Note:

• Fixed Doll disconnect when spawn due to consecutive teleport packet with same teleport id
• Fixed high CPU and Ram usage when convert-player is enabled
• Decreased Doll teleport delay in Folia server

Patch Note:

• Fixed teleport packet causing doll to disconnect when spawn
• Added hidden flag for gset and pset
• Added config key display-doll-when-ping
• Added config key op-can-see-hidden-doll
• Added check for Error UUID when spawn
• Added support for flying

Hidden flag

permission: playerdoll.personalflag.hidden

default: disabled

With this flag enabled, all players (or specific player):

• cannot see or interact doll hitbox in the world
• not listed from tablist
• not listed from ping list

Pset overrides Gset

Display Doll When Ping

default: false

This control the online count, max player count when player ping the server.

if disabled:

• all dolls will be filtered from online count
• original max player count will be shown (if adjustable-max-player enabled)

Op Can See Hidden Doll

default: true

Does server operator bypass the hidden flag

Flying

If caller is in Creative and the doll can fly, doll will remain flying when spawn

Other

• Config version is now 26
• Updated default.yml

Patch Note:

• Fixed Create command cannot bypass max-create limit using manage or in op
• Added Info command
• Removed gset/pset info flag
• Added doll setting hide_from_list flag
• Adjusted pset config-saving check (if pset player has identical settings from gset, the setting will not be saved)
• Fixed an error that trying to use pset to set a specific flag on a player that was never presented on doll config
• Optimized command suggestions (Hover Texts)
• Adjusted Doll teleportation (using packet)

Hide From List flag

permission: playerdoll.globalflag.hide_from_list

If hide_from_list flag enabled, Doll will be hidden from suggestion list when player is typing info command

• This flag does not affect op or owner
• This flag does not block info query made from other player

Info command

permission: playerdoll.command.info

A command for listing basic data of Doll

• Doll name
• Online status
• Owner
• Doll settings
• General settings
• Player settings

Command Suggestion Hover Text

Added a related Hover Text display on Doll target selection to the command.

Can be seen by dragging the mouse cursor onto the tab suggestion

• spawn, give, remove -> owner name
• tp, despawn -> current coords
• look, turn -> current facing
• slot -> current handheld slot
• exp -> current level
• mount, dismount -> is riding
• sneak, unsneak -> is sneaking
• sprint, unsprint -> is sprinting
• set, gset -> enabled flags
• pset -> players being pset before
• actions -> items on both hands

Others

• Config version is now 25
• Updated default.yml and zh.yml (available on Github)
• Published the plugin in release channel (stable)

Patch Note:

• Fixed chat-when-join

Patch Note:

• Fixed a Crash issue due to RealPlayerTickAction in Folia
• Fixed Doll becoming invulnerable after entering the The End exit portal in Folia

Patch Note:

• Fixed Doll death from PlayerData Sync PluginNow Doll will attempt to respawn then disconnect the Server. To prevent Sync Plugin store Doll data at 0 Health.

Patch Note:

• Changed disconnect method from server side to fake-client side
• Changed TP method from console command execution to API teleport
• Fixed perm.yml max-doll-create counts incorrectly
• Fixed Pset data is not loaded correctly when doll spawn
• Fixed Give command is not working (Now Give command require Doll to be offline, and the receiver to be online)

Patch Note:

• Fixed an issue that when Doll was Removed by non-owner, the max-creation-counter is not update correctly
• End Dev test

Others:

• No update for BungeeCord plugin, download if needed. See v1.29
• Simply tested on the latest clean Velocity with forward setting "modern", PlayerDoll should work fine without implementing a dedicated Velocity plugin. (for Doll connection)Also no need to change config settings

Patch Note (dev version):

New Features

• Added messages to Doll caller about spawn result
• Added Lang config keys spawn-success and spawn-error

Bug Fixes & Changes

• Fixed an issue that in some versions and branches that cannot perform command through Shortcuts or GUI buttons
• (BungeeCord) Fixed Doll will no longer be able to join the server if an connection error occurred before
• Simplify some logging messages

Others

• Config version is now 24
• Dev test will end in this version if no specific problem was found

Patch Note (dev version):

BungeeCord Connection Support

New Features

• Support 1.21 Paper (experimental-build #9)
• Support 1.20.3 - 1.21 BungeeCord Connection
• Added config key proxy-auto-join-delay, to delay (in seconds) each Doll when joining automatically
• Added doll config key last-join-server for server Name that will be used in auto join. (doll without no server name are not joining)

Bug Fixes & Changes

• Fixed a crashing issue that server reload command interferes with doll brigadier command
• Changed config key server-ip and server-port to proxy-ip and proxy-port respectively for Proxy connection
• Doll will connect to the local address automatically when BungeeCord mode is off.
• When BungeeCord mode is on, Doll auto join feature requires at least 1 player in server. When the first player joined, doll will start joining 1 by 1 after 5 seconds.

Others

• BungeeCord-side plugin is available below (PlayerDoll-Bungee-1.28.jar)
• GUI command actions are not working in BungeeCord mode in some versions and server mods. Entering command in chat as an alternative
• Doll in BungeeCord mode might not joining the game rarely. Please try again (around 5%?)
• To trigger doll auto join after reload in Bungeecord mode, a player is required to join the server in order to start.

Patch Note (dev version):

New Detailed Readme in github

New Features

• Support 1.20.3 - 1.20.6 spigot/paper/folia
• Support 1.21 spigot
• New Chinese translated yml (zh.yml) has been uploaded to github (by anonymous author)
• Changed command system to vanilla brigadier for better experience (test)
• Added dollmanage command to execute command without most validation (default for OP)
• Changed Doll Connection from NMS connection to Socket connection (should be more flexible and faster)
• Convert-Player feature now support more actions, lookat drop, dropStack, swapHand

Bug Fixes & Changes

• Rewrote the plugin
• Should be less spaghetti code
• Removed most of the side feature (not affect the major usage of plugin)
• Renamed and Combined some similar command (also permissions)
• Reduced NMS file size by reflection & abstraction & wrapper (Methods that not changing at all)
• Clean up unused config keys
• Changed default language config from english to default
• Convert-player self indication is changed from ! to _ (underscore)
• Fixed doll ticking action pack in abnormal speed
• Create command now uses GameProfileIn online-mode, GameProfile will not exist if player is not in mojang database. GameProfile will not contain skin data unless the player has joined the server before.In offline-mode, GameProfile will always exist, skin data is always empty.Also removed fetching skin data online.
• Now create command is determine by player permission "playerdoll.argument.create.skin"
• Removed support of Offline Doll for some command
• Fixed perm.yml cannot change doll prefix / suffix
• Default permission from perm is now default to all players (if enabled), no need to set manually
• Config provided port and ip for Doll to connect, default 127.0.0.1 and 25565. Change it if the server setting is different

Other

This is a dev version, the major purpose of this version is for public test. Most of the feature has been tested and ensured to function properly, but there might still be problems that happen due to different environments.

Please report if any problem found

It is suggested to remove configs (except doll config) to generate a new config that comes with comments. Or you can nevigate the original config inside plugin Jar

• BungeeCord connection is not implemented
• Config version has changed to 23
• The removed features will be added back if needed or by request
• Some minor changes are not stated

Patch note:

• Support Paper 1.20.5
• Minor Tweaks
• Fixed Doll not disconnect immediately

Paper 1.20.5

Plugin tested under Experimental build #6, no error was found

Changed some logic for getting server version as Paper (also downstreams) NMS not including CraftBukkit version anymore

Patch note:

• Support 1.20.5

Connection process has changed in 1.20.5, potiential problem might occur.

During basic test on Spigot, no severe problem found yet.

Patch note:

• Added Basic config key convert-player (Test)
• Minor tweaks
• some code transition

Convert Player

A setting to convert player entity into modified player entity, to support some doll commands (actions)

Default: false (not to convert)

When Player is connecting to the server, if the setting is true, A modified Player Entity will be created instead of original one. The modified player has a feature of automation action added.

• Added new command target ! for self indication (i.e. [/doll attack ! interval 10], player-self attack in interval of 10 ticks)

Example

Notes

When setting is true, Server Reload command is not recommanded.

Converted players will be kicked from the server. (Once reloaded, the plugin has no access to player entity anymore, because of different class loader)

Others

• Config version is now 22

Known Issues

• Self selecting (!) in doll commands not showing suggestions

Patch note:

• Changed Doll BungeeCord connection method (Test)
• Removed proxy-ip proxy-port keys from BasicConfig
• Added doll-multi-instance key to prevent dolls with same UUID joining multiple BungeeCord servers
• Added messaging between Plugin and BungeeCord for searching duplicate Doll

BungeeCord Connection Method

Last version, doll joins wrongly in random. To fix this, A new Stable Connection Method is implemented for Testing.

• Doll will connect to game Directly instead of BungeeCord
• Doll will no longer be listed from BungeeCord commands
• Doll will not be kicked when BungeeCord Restarts

Note: There might be plugins that block BungeeCord-bypassing connection, this connection method might be affected. Please Report on Github if this happened.

Doll-Multi-Instance

If there are dolls with duplicate UUID in multiple servers, this option prevents plugins that sync player data across server producing dupe by making doll with same UUID can only spawn once. This option will enable only BungeeCord mode is true. Default: false (disallow multiple instance)

Patch note:

• Added BungeeCord support (Test)
• Added proxy-ip and proxy-port on BasicConfig for Doll connection when BungeeCord in used
• Changed whitelist logic
• New BungeeCord plugin is implemented.
• Config version changed to 19
• Added perm.yml
• Fixed lang.yml is not updating
• Fixed Join message setting not work
• Adjusted Give command to require target to be online

BungeeCord (Test)

For Servers running on bungeecord mode, proxy-ip and proxy-port are provided on Basic Config. All doll will connect to the target address instead of the server itself. Please report any problem on Github.

Note:

1. When using BungeeCord mode, sometimes Doll will join as single character name, which represents this connection is failed to manipulate, spawn again could solve.This might different from environments.
2. Doll with same name among servers are not allowed to spawn at the same time.
3. On BungeeCord, doll will connected as single character name temporarily. This does not affect /find or /glist command as doll will convert to their real name after joining the server successfully

perm.yml

A new mini permission setting config is added. It allows server owner to set detailed settings for dolls. Like prefix, suffix, max-spawn, max-create. (restrict skin is not implemented)

These permission node are suggested to add under groups for convenience.

Example: playerdoll.perm.max-doll-spawn.default is bind to default permission group. When player with default permission group enter /doll spawn command, the plugin will check to see if the player contains permission of playerdoll.perm.max-doll-spawn.default, then fetch the corresponding value from perm.yml and do the check.

Description and Example are on perm.yml

Patch note:

• Enhance Doll spawning Stability
• Adjusted fake connection process to reduce spawn failure

Patch note:

• Added whitelist-bypass when Doll Join(Enabled only when server is using whitelist)
• Added Basic Config Keys chat-when-join & chat-when-join-interval for Doll to execute something when they join
• Fixed Config version not updating automatically
• Fixed Flag config not saving new keys
• Fixed Folia server real_player_tick_action causing Doll to disconnect.

New Basic Config Keys

chat-when-join-interval

• This Controls the delay between each message (in tick)

chat-when-join

• This List controls what message will be send to the server by the Doll
• Can be commands or regular messages
• Input variables %name% and %uuid% to represents Doll's name and uuid respectively
• This should be useful for Logging in on offline server

Patch Note

• Added Async PlayerPreLoginEvent while Doll Joining
• Added Packet Filter to reduce packets sent from Server to Fake Client
• Fixed Doll Exceeding Packet Rate Limit by packet filter
• Implemented Doll Setting [Real Player Tick (Action)]

Patch Note:

• Updated documentation on Github
• Removed support for 1.20-1.20.2
• Removed redundant side functions
• Removed built-in permission
• Remade Config for better management (Not Complete)
• Remade Doll Joining Logic to provide real-player alike process (Maybe the best way to eliminate interferes with plugins)
• Used Logger to replace System.out
• Internal changes
• Clean-up codes

Permissions

• Now only OP is able to call actions, unless a permission managment plugin is installed
• Details on Github

Configs

• Now config has reworked, there should be some problems while handling config file update.
• Detailed implementation at future version.
• Renamed many keys

Affected Configs [Doll config/Basic config/Flag config/Language config]

• *Please re-generate a new one to avoid errors

Dolls

• Now dolls will Emulate a client to deal with [no connection error] from server side plugin handling.
• Using a internal fake client may produce unforeseen problems. Test from Author, it should be fine on some basic usages.
• Using a client can extend controls of Doll in the future, like scripting or other interactions.
• For Doll being kicked by Exceeding Packet Rate Limit when Join, temporary solution

Others

• Some settings will temporarily hardcoded or cancelled, like Doll prefix/suffix, spawn limits.

Patch note:

1. Changed Some Doll Spawning algorithm to enhance compability
2. Enabled vanilla kick command to doll on Folia
3. minor fix

Patch note:

1. Fixed some command selection not displaying
2. Fixed error while handling PlayerJoinEvent with other plugins
3. Adjusted timing of Doll joining when server start
4. Fixed Doll GUI poping up error alert
5. Fixed Doll auto-joining spawned at weird position

Notice

• If you are using plugin version above [v1.20], please download this version [v1.24] as soon as possible.In order to fix the problem that some plugin's PlayerJoinEvent has no effect on regular Players.

Patch note:

1. Fixed Doll spawn Error on Folia (1.20.2-1.20.4)
2. Code clean up
3. Apply v1.22 [Aplha test] contents (welcome to report issues)
4. Increased Doll teleport delay on Folia to avoid Doll entity hitbox unsync when Spawn (5tick -> 10tick)

Others

• Doll setting "hide from list" is not implemented
• Doll command "info" is not implemented

Notes

• Beta release will end after few versions if the plugin becomes stable (after May)
• Pre & Post MC 1.20 will slowly support after beta release
• Plugin will be less frequently updated until May for longer observation

Patch note: [Alpha release]

1. Implemented Auto-update Config
2. Implemented Config modification detector
3. Remade Permission related system (Test)
4. Added playerImmune on permission.yml
5. Changed Doll UUID from Name to Random generation
6. Made support to server using LuckPerms (Test)
7. Code clean up

Configs

Auto-Update

• Apply to config, lang, flag, perm
• Added key ReplaceConfig on config.yml for config update behavior(true : replace the whole config by new version[lost all settings]false : add missing keys to config[no longer maintain format, comments are missing])
• If you want to check the original newer version config, open Plugin.jar as ZIP and then open the config file

Modification Detector

• Apply to config, lang, flag, perm
• Added key AutoReload on config.yml for detecting changes.
• Automatically update when changes detected in Real Time
• Without typing reload commands

Permission (Test)

• Remade permission.yml
• catagroized configurations
• added playerImmune key (Make Doll no longer damagable by Player)
• If no LuckPerms in use, extra storage playerPerm.yml will appear (Record of player UUID - permission group)
• Abandoned old player/uuids.yml
• now all players are having default group by default, players will not be saved when they are under default group

Added attachkey (String list) for LuckPerms permission groups (Primary Group Name)

in Test function

If you are using LuckPerms and having own permission groups
you can assign those groups into `attach` key
player belongs to that permission group will automatically apply to PlayerDoll permission group in Runtime.
(Both groups are not interfering with each other)

UUID

• Doll Name used to be the UUID of Doll, it caused some annoying problems when using Rename
• New Doll will use a randomly generated UUID
• It should be no impact for old and new version of Doll

Others

• now config version has changed to "17"
• Please backup the config before starting up the server
• Please Re-generate Permission.yml
• Please report any problem you encountered
• Doll setting "hide from list" is not implemented
• Doll command "info" is not implemented
• This release is not fully tested, please report if any problems found

Patch note:

1. Optimized Events handling when Doll spawn (Prevent plugins from getting error while handling Dolls)
2. Fixed error when Create doll with invalid Player Name (Profile not exist for MCJE)
3. Implemented Permission Group upgrade function (Test)
4. Disabled most command execution from console

Skin

• Default Mojang skins will be used when invalid skin has been used (Specified a invalid name, or creator has no Profile data)

Event Handling

• Prevented other Plugins from handling Doll spawn
• Enhanced stability
• Tried to re-wrote to eliminate potential errors

Permission Group Upgrade

• command : /dollUpgrade [confirm] (confirm to ignore tip message and upgrade)
• Only usable when Vault exist
• Under Test

Others

• now config version has changed to "16"
• Please backup the config before starting up the server
• Please report any problem you encountered
• Doll setting "hide from list" is not implemented
• Doll command "info" is not implemented

Patch note:

1. Reverted FakeChannel.class handling due to imperfection
2. Added new method to Prevent other Plugins from executing PlayerJoinEvent when Doll join (For Test)

1. The new method should completely preventing other plugins from executing PlayerJoinEvent to produce error
2. This should execute only when Doll Spawn
3. Please write an issue if this method is causing any error (behave wrongly) or incompatibilities

Note: This method rely on Event priority & Plugin Load Order, which if there is plugin that load prior than this Plugin and with the same priority (Lowest) may produce some problem (listen and make changes to PlayerJoinEvent). [Edited 17-Jan]

Patch Note:

1. Added FakeChannel.class that warped EmbeddedChannel.class for compatibility (Handle Fake Player by Other Plugin)

Patch note:

• Fixed non-OP cannot get Dolls from certain suggestion type

Patch note:

1. Remade GUI system to support offline set/gset/gset
2. Fixed GUI page swap resetting cursor position
3. Fixed GUI button bypass command permission
4. Fixed doll inventory navigation desync
5. Fixed OP bypass doll online check
6. Fixed Remove not dropping loots
7. Fixed command check ignored Admin flag
8. Fixed Menu shortcut bypass permission
9. Implemented tab suggestion filter appropriate suggestions
10. Modified some config keys
11. Player can now set / gset / pset without doll online (Test)
12. Added several suggestion types
13. Changed some command suggestion for better indication

GUI system

• Re-implemented for better fulfill the needs
• Should come with better performance and less resource usage
• The system is in test, please report any problems
• Removed back button in Set page
• Removed ender chest exit function

Others

• now config version has changed to "15"
• old version.txt on Github no longer update
• Please Re-create the Dolls to avoid error
• Please backup the config before starting up the server
• Please report any problem you encountered
• Doll setting "hide from list" is not implemented
• Doll command "info" is not implemented
• Permission group upgrading is not implemented

Patch note:

• Compiled in Java 17 to ensure compatibility
• Added softdepend in plugin.yml for Vault

Starting from 1.19.1, plugin will compile in Java 17. (currently 19) If you are using Java 17, please check v1.19.1 (9-Jan)

Patch note:

• Added Backup function on Config for Doll configs
• Added Remove function on Config for Inactive player
• Added Command Alerts
• Removed redundant canGiveDoll canRenameDoll permission settings
• Added costPerDoll costForUpgrade in permission
• Supported Vault for Test (command Create)
• Modified & Fixed minor problem in language config
• Added LastSpawn field in per Doll config

Others

• now config version has changed to "14"
• Doll config might not function, please re-create the dolls
• Please backup the config before starting up the server
• Please report any problem you encountered
• Doll setting "hide from list" is not implemented
• Doll command "info" is not implemented
• Permission group upgrading is not implemented
• Tab suggestions will not filter appropriate targets

Patch note:

• Updated Readme on Github (5-Jan)
• Fixed error when Remove Doll (5-Jan)
• Added bypassResidence permission for test (5-Jan)
• Remade Command system to match Tab Suggestion system
• Added permissions canGiveDoll canRenameDoll canJoinAtStart
• Updated and Cleaned up some configs
• Changed Remove to Immediate remove all data of Doll
• Changed KeepInventory to not apply when Remove
• Fixed when first / re- loaded plugin cause Player can create Doll regardless the limits
• Updated Drop command usages to Drop [stack] [...]
• Updated Text in DollLimit
• Code clean up

Command

• New system is testing, please report on Github when you encounter any problem (Also tab suggestions)

• Some Commands are no longer require online Doll execution (Rename/Remove)

Known issues

• some command alerts are not displaying
• tab suggestions will not filter appropriate targets

Others

• now config version has changed to "13"
• config has clean up some usused Global settings
• in this version, old doll config might no longer able to display GUI settings, please re-create the dolls
• please backup the config before starting up the server
• please check dollhelp command to see the detailed usage
• please report any problem you encountered.
• doll setting "hide from list" is not implemented
• doll command "info" is not implemented

Patch note:

• Fixed check update console error
• Added config CheckUpdate to toggle alert when server start
• Implemented permission group and permission.yml settings (testing, not a complete version)
• Added dollLimit command to check self permission
• Detailed dolleHelp descriptions and hover texts
• Remade command Tab suggestion System to improve performance and intelligence
• Fixed Remove Rename that do not update playerdata.dat_old
• Added Storage of playeruuid permissions

Permission Group

This is a system that manage player using PlayerDoll.

it provides a list of settings for Server owner to controls player ability.

OP will ignore most of the permission settings.

*This is under development, please report any issue encountered.

New Tab Suggestion System

Now the suggestion System will provide what you can type for the upcoming argument.

If an invalid argument is typed, it will suggest nothing if there is further suggestions.

Also it will depend on the typed argument to suggest a valid suggestion. (Before it is base on the index of argument to provide suggestion)

Type arguments ( )

• Fill in anything that match the type will pass the check
• ie <POSITIVE_INTEGER> -> then you can type any integer that > 0

Fixed arguments ( arg )

• Directly use the suggestion as arguments.

Any arguments ( ? )

• Can fill anything but empty

flag.yml

• Now flag.yml has only contains key-value pairs of command and Item name
• Default values has move to permission.yml

permission.yml

• Group "default" should not be modified
• Flag.Display controls the visibility of GUI items
• Flag.Toggle controls the default on/off of Doll

*Flag.Display has not yet supported Enable/Disable player command

Others

• now config version has changed to "12"
• doll config has updated, please aware
• please backup the config before starting up the server
• please check dollhelp command to see the detailed usage
• please report any problem you encountered.
• doll setting "hide from list" is not implemented
• doll command "info" is not implemented

Patch note:

• Added 1.20.4 support
• Extracted most repeated NMS code to reduce file size
• Fixed Pushable icon display unsync when Doll spawn
• Fixed weird knockback while Doll holding shield
• Fixed dropping item from Doll inventory slot caused item disappearing in Folia
• Fixed doll config checker not updating doll config
• Fixed error that sending command with interval field with empty tick value
• Added new doll setting "pickup-able" to control pickup behaviour of Doll
• Implemented "lookat" target field with action support
• Removed share/unshare from command selection and dollhelp

lookat

• now can select "target" as the nearest Entity of player's line of sight (Exclude player)
• if selected "target", actions can be used (once/continuous/interval) to consistently lock on the target entity

Other

• now config version has changed to "0.0.11"
• please backup the config before starting up the server
• please check dollhelp command to see the detailed usage
• please report any problem you encountered.
• doll setting "hide from list" is not implemented
• doll command "info" is not implemented

Patch note:

• Added 1.20.3 support (need more test) [6-Dec]
• Fixed Language config loading problem [6-Dec]
• Changed Scoreboard prefix/suffix to directly modified name [6-Dec]
• Added set/gset/pset/exp/inv/echest/ commands
• Corrected spelling in langugage config
• Hid Doll identifier in some messages
• Added configurable [plugin] prefix for player messages
• Updated dollhelp command suggestions to match input format
• Fixed error logging when click specific GUI items
• Removed extra empty line in dollhelp overlay text
• Fixed error logging when Doll was kicked
• Fixed error logging when input action command arguments
• Removed (un)share command
• Removed shared Doll from displaying on command suggestion
• Improved some code

Config version has updated to 0.0.10

Folia can now display Doll prefix/suffix

Share in Doll config has replaced by generalSetting & playerSetting

Please check dollhelp command to see the usage

Please report any problem you encountered. (especially for gset pset)

set -> basic doll settings

gset -> setting for all players (not pset before)

pset -> override gset setting for specific player

order of permissions:

[flag.yml (default) < gset (manually set) < pset (manually set)]

• If a flag has not been set once in gset/pset, it will follow the order

Admin flag = enable all listed flags (not include owner command)

Patch note:

• Edited config version not updated to 0.0.9 (edit 2.Dec)
• Added rename command (owner)
• Added give command (owner), to transfer owner of Doll
• Fixed preserved Name not working
• Changed Doll Data deletion Timing
• Fixed doll Config save repeatedly
• Changed command input to
• Optimized command target suggestion to match action requirement & permissions

Config version has changed to 0.0.9.

Bugs / Ideas / Unintuitive behaviors : Please report on Github

Since plugin is more stable, the update pace will slow down.
Some future update plans (not neccessary in recent future updates)
- Per & Global player doll setting to replace (un)share command
- Other plugin support
  |- Purchasable things using money plugin
  |- other suggestions?
- Permission group implementation
- other suggestions?

Patch note:

• Fixed doll Create error when player was not admin.

Patch note:

• Changed server mod detection method (Edited 26.Nov)
• Supported multi versions (1.20 - 1.20.2)
• Separated Global config & Doll config (no preserved names)
• Fixed server Reload did not save Doll config
• Changed Doll Prefix to scoreboard
• Added Suffix for Doll in Global config
• Forced Doll identifier in front of name (-)
• Added display settings of Join/Death/Quit message in config
• Cleaned-up code

Config version has changed, please backup before starting the server. Doll configs stored in previous version might produce error.

Please write an issue on Github if any bugs / ideas.

Notice:

• Folia have no support on scoreboard API, prefix&suffix are not working currently
• PreservedName is kept for disallowing some names from using
• Now all Doll name has max of 15 characters
• when using Doll command, identifier is not required to type

Patches:

• Added auto join support for Folia
• Adjusted auto join description
• Removed Github URL from update checking.
• Fixed Remove not updating config correctly in some situations
• Doll UUID has changed in config to match UUID in game

Config version has changed, please Backup the configs before starting the server.

Known Issue:

• Doll is not saving when Server reload / Shutdown.

Please manually disconnect once to save config&data to prevent data loss.

Patches:

• Fixed that when Doll exposes to monster causing error
• Fixed Doll not align correctly when spawn
• Added Doll auto join setting*
• Added Global Doll join setting*
• Fixed Doll data not clearing when Remove
• Added Doll setting check in Spawn (Add missing settings)
• Changed some Doll spawning logic
• Changed some Remove and First Spawn logic.

*Doll will automatically join when server start (Not applicable to Folia Server)

Config version has changed, please Backup configs before starting server.

Known Issue:

• Doll is not saving when Server reload / Shutdown.

Please manually disconnect once to save config&data to prevent data loss.

Patches:

• Fixed 1.20.2 Doll spawning error.
• Separated Code for Spigot, Paperseries, Folia.
• Added Server mod Manual setting in config for some less popular branches.
• Reformatted Settingmenu display.
• Added Settingmenu display Settings. (test)
• Fixed some config not working.

Config.yml & Flag.yml has updated. Please delete and Backup in order to generate a newer version.

Please state any ideas/improvements on Github if you have.

1. Fixed Server player count not change when Doll join.
2. Used another dimension changing approach. (Portal teleport)
3. Added Global config : DollNotCountSleeping (Doll will no longer take count in sleeping percentage)
4. Added Doll Setting Option : Phantom (Phantom will not spawn at Doll even if Doll does not sleep)

Starting from v1.7, Folia can run this Plugin. Please report on Github if you encountered any issues.

Config files has changed. You should backup them before starting up the server.

Using old configs might led to errors.

You might add "setting - Phantom : true/false" field to every Doll config to avoid error.

1. Minor fixes
2. Try to support Folia (Basic functionality are done in Folia 1.20.1, need more tests in different versions)

Starting from this version, Plugin supports Folia.

Non-Folia user can still use this jar.

Please report any issues on Github.

For minecraft 1.20 - 1.20.1 please download jar 1.20

For minecraft 1.20.2 please download jar 1.20.2

Please select a corresponding game version to download underneath.

Patches

• Added Native Paper chunk loading logic for Paper/Purpur
• Reworked Commands
• Fixed Tab suggestion causing Error
• Separated Spawn command to Create & Spawn
• Renamed Set command to menu
• Improved some command parameter
• Improved command Listing format
• Fixed doll inventory Numkey operation perform wrongly
• And some others

Known Issues:

• Doll Skin cannot be set manually through config

Please report any issues on Github when encountered.

Note: Config files has changed. You should backup them before starting up the server.

Using old configs might led to errors.

Due to techical diffculties, the old versions of this plugin will no longer update when beta test ends (unless there are ways to have fully multi-version support).

Version update

Support 1.20.2

Patches

• Removed ChunkLoad configs
  • Plugin will keep manually keep chunk loading until native method of Paper chunkloading is found.
• Added config auto updater (It will overwrite old data, please do backups)
• Added plugin version checker
• Remake Doll gui functionality
• Added 'Attack', 'Use', 'Copy', 'Mount', 'Dismount' to Setting panel
• Added interactive Doll Inventory GUI
  1. Left Click -> Set Handheld
  2. Right Click -> Set Handheld & perform Use command
  3. Shift + Left -> Swap between hotbar & other slots
  4. F key -> Swap between offhand & hovering slot
  5. Num keys -> Swap between hotbar number slot & hovering slot
  6. Q & Ctrl + Q -> Drop (Drop stack) hovering slot
• Certain GUIs can click empty space to go to previous menu
• Prevented empty doll file causing error
• Fixed doll cannot save while Server Reload
• Added gui menu exit function when doll is offline
• partial code clean up
• code rework

Known issues:

• Doll Skin cannot be set manually through config
• Chunk loading breaks in Paper/Purpur
• Command Tab might cause error due to high latency (need test)

Notice: some config files (doll files, language, config, flags) has changed. You should backup them before starting up the server

Patches

1. Read-only Doll Inventory
2. Simplify Doll Inventory
3. Pearl now does teleport Doll
4. Respawn reset fall-height
5. Doll not swinging hands in some situation
6. Added Skin data saving in Doll.yml
7. Added swap hand command
8. Adjust drop command

Language config has been updated, you can delete the yml and regenerate a newer version

Patches

1. Server operators can now bypass Doll creation limit
2. Add underscore (_) sign support as Doll name

Patches

1. Empty Doll yml creation while Doll creation failed
2. Optimize plugin reload command logics
3. Optimize server reload logics
4. Doll will disconnect when server reload

1.0 beta release

please report if you have any bugs/ideas.

Not recommend for public use currently.