PlayerDoll

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 ( <arg> )

• 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 <action> <target> <args>
• 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).