DynaFakePlayer · Official Setup Guide

From zero to fully set up.

Installation, license activation, proxy/backend setup, every documented command, troubleshooting, and account security.

១. មុនពេលដំឡើង

ប្រើ Java version ដែលត្រូវនឹង Minecraft/server software របស់អ្នក; កញ្ចប់ source ដែលបានពិនិត្យណែនាំ Java 21។
ត្រូវមាន Proxy មួយ (Velocity ឬ BungeeCord/Waterfall) និង Paper backend ដែលបានភ្ជាប់ network រួច។
បង្កើតគណនី និង Claim Free License ក្នុងអំឡុងពេលប្រូម៉ូសិន ២ ខែ។ កុំចែករំលែក License Key, config.yml, sync.properties ឬ sync.token។
បិទ server មុនពេលដាក់/ដក plugin។ កុំប្រើ Bukkit `/reload` ឬ proxy hot-reloader។

២. បង្កើតគណនី និង Claim Free License

ចុះឈ្មោះដោយ Email និងបញ្ជាក់លេខកូដអ៊ីមែល ប្រសិនបើត្រូវបានស្នើ។
ចូលទៅកាន់ My Licenses ហើយចុច Claim Free License ខណៈប្រូម៉ូសិន ២ ខែនៅដំណើរការ។ មិនចាំបាច់បង់ប្រាក់ ឬបញ្ចូល payment information ទេ។
License System នឹងបង្កើត license key ពិតនៅលើ server ហើយបង្ហាញ key និងប៊ូតុង Download plugin នៅក្នុង account របស់អ្នក។ កុំចុច claim ច្រើនដង ប្រសិនបើវាកំពុងដំណើរការ។
License បច្ចុប្បន្នអនុញ្ញាតដល់ 3 Proxy activations និង 6 Backend activations។ ចំនួន Online អាចខុសពីចំនួន Bound/Used។

៣. ដំឡើងលើ Proxy (Velocity / BungeeCord / Waterfall)

ទាញយក JAR ពី My licenses → Download plugin។
ដាក់ JAR ក្នុង `plugins/` របស់ Proxy។ សម្រាប់ Velocity សូមពិនិត្យឱ្យបានត្រឹមត្រូវថា JAR ជាកំណែដែលគាំទ្រ Velocity។
ចាប់ផ្ដើម Proxy ម្ដង ដើម្បីបង្កើត config។ បិទ Proxy មុនកែ config។
បើក config របស់ DynaFakePlayer ហើយបញ្ចូល License Key ពិតរបស់អ្នក ជំនួស `NONE`។ កុំបង្ហោះ config ជាសាធារណៈ។
ចាប់ផ្ដើម Proxy ម្ដងទៀត។ វាបង្កើត `sync.properties` និង `sync.token`។ រក្សាឯកសារនេះជាសម្ងាត់។
ពិនិត្យ `/vdfp status` សម្រាប់ Velocity ឬ `/bdfp status` សម្រាប់ BungeeCord/Waterfall។

៤. ដំឡើងលើ Paper Backend

ដាក់ JAR ដែលគាំទ្រ Paper/Bukkit ក្នុង `plugins/` របស់ Backend នីមួយៗ ហើយចាប់ផ្ដើម server ម្ដងដើម្បីបង្កើត config។
បិទ Backend ហើយកំណត់ License Key តាមការណែនាំរបស់ release របស់អ្នក ប្រសិនបើកំណែនោះទាមទារ Key នៅលើ Backend ផងដែរ។ ប្រើ Key ដូចគ្នារបស់ License មួយ ប៉ុន្តែកុំចែករំលែកវា។
ចម្លងតម្លៃ `sync.token` ពី Proxy `sync.properties` ទៅ `proxy-sync.token` ក្នុង config របស់ Backend នីមួយៗ។ កុំបង្កើត token ផ្សេងដោយខ្លួនឯង។
កំណត់ `proxy-sync.server-name` ឱ្យមានឈ្មោះខុសគ្នាសម្រាប់ Backend នីមួយៗ ហើយត្រូវត្រូវគ្នានឹងឈ្មោះដែល Proxy ប្រើ។
បើ Backend នៅលើម៉ាស៊ីនផ្សេង សូមកំណត់ bind-host/port តាមការណែនាំរបស់ release និងកំណត់ firewall ឱ្យអនុញ្ញាតតែម៉ាស៊ីនដែលទុកចិត្ត។ កុំបើក port សាធារណៈដោយគ្មានការការពារ។
ចាប់ផ្ដើម Proxy និង Backend ទាំងអស់ឡើងវិញ។ ប្រើ `/dfp status`, `/dfp network` និង `/vdfp status` ឬ `/bdfp status` ដើម្បីពិនិត្យសុខភាព។

ចំណាំ៖ ឈ្មោះ config និងទីតាំងអាចខុសតាម build។ អាន README/INSTALLATION ដែលភ្ជាប់ជាមួយ JAR ដែលអ្នកបានទាញយក។ កុំយក config របស់ release មួយទៅប្រើជាមួយ release ផ្សេងដោយមិនប្រៀបធៀប។

៥. Command Reference — Backend / Paper

Command	មុខងារ
`/dfp help`	បង្ហាញជំនួយ និង command សង្ខេប។
`/dfp status`	ពិនិត្យ target, profiles, bridge និង sync។
`/dfp doctor [repair\|all]`	ពិនិត្យការចុះឈ្មោះ ហើយសាកល្បងជួសជុល entries ដែលបាត់។
`/dfp gui [page]`	បើក Admin GUI។
`/dfp compatibility`	បង្ហាញ compatibility adapters។
`/dfp network`	ពិនិត្យការសម្របសម្រួល Proxy/Backend។
`/dfp benchmark`	វាស់ runtime cost។
`/dfp exportdebug`	បង្កើត diagnostic report ដែលដក secrets ចេញ។
`/dfp rejoin <name\|all>`	ដោះ identities ដែលបាន quarantine ក្រោយ kick/disconnect។
`/dfp toggle`	បើក/បិទ automatic spoofing។
`/dfp set <amount\|-1>`	កំណត់ចំនួនគោលដៅ; `-1` ប្រើ multiplier/fluctuation។
`/dfp multiplier <value>`	កំណត់ multiplier ចាប់ពី 1.0 ឡើងទៅ។
`/dfp profiles generate <amount>`	បង្កើត saved profile identities។
`/dfp profiles list`	បញ្ជី profiles និងស្ថានភាព Online។
`/dfp profiles clear`	លុប saved profiles ទាំងអស់។
`/dfp spawn <name>`	នាំ profile មួយ Online ដោយដៃ។
`/dfp despawn <name\|all>`	ដាក់ profile មួយ ឬទាំងអស់ Offline។
`/dfp remove <name>`	លុប saved profile។
`/dfp skin <name> <skin-owner>`	ស្វែងរក និងកំណត់ Minecraft skin។
`/dfp skins status`	បង្ហាញចំនួន skins ដែល resolve រួច។
`/dfp skins refresh`	Refresh skin cache។
`/dfp ping <name> <0-60000>`	កំណត់ latency ក្លែងក្នុង milliseconds។
`/dfp chat <name> <message>`	ផ្ញើ chat តាម fake-player path។
`/dfp sudo <name> <command>`	ដំណើរការ command ជា fake player។
`/dfp persist <name> <true\|false>`	កំណត់ឱ្យ profile ត្រឡប់មកវិញក្រោយ restart ឬអត់។
`/dfp behavior <name> <group>`	កំណត់ passive/wander/follower/aggressive/afk។
`/dfp gamemode <name> <mode>`	កំណត់ survival/creative/adventure/spectator។
`/dfp item <name> <material>`	កំណត់ item នៅ main hand។
`/dfp equipment <name> <slot> <material>`	កំណត់ mainhand/offhand/helmet/chestplate/leggings/boots។
`/dfp permission <name> list`	បង្ហាញ permission nodes របស់ profile។
`/dfp permission <name> <add\|remove> <node>`	បន្ថែម/ដក permission node។
`/dfp info <name>`	បង្ហាញស្ថានភាព profile។
`/dfp reload`	Reload config និង runtime adapters។
`/dfp save`	បញ្ជាទុក profile ភ្លាមៗ។

៦. Command Reference — Proxy

Velocity: ប្រើ `/vdfp`; BungeeCord/Waterfall: ប្រើ `/bdfp`។ Commands ភាគច្រើនត្រូវបញ្ជាក់ Backend server name ជាមុន។

Command pattern	មុខងារ
`/vdfp status` / `/bdfp status`	ស្ថានភាព snapshot, transport, queue និង registry។
`/vdfp repair`	សាកល្បងជួសជុល Velocity registry bridge។
`/vdfp set <server> <amount\|-1>`	កំណត់ target របស់ Backend។
`/vdfp multiplier <server> <value>`	កំណត់ multiplier របស់ Backend។
`/vdfp spawn <server> <name>`, `despawn <server> <name\|all>`	បើក/បិទ profile នៅ Backend ដែលបានជ្រើស។
`persist/chat/sudo/skin/ping/behavior/gamemode/item/equipment/permission <server> ...`	គ្រប់គ្រង profile និងសកម្មភាពរបស់វា។ បន្ថែម subcommand និង arguments តាម `/vdfp help` ឬ `/bdfp help`។
`server <server> <name> <assigned-server>`	ប្ដូរ assignment metadata ប៉ុណ្ណោះ។ មិនមែនផ្លាស់ទី profile Online ទេ។
`move <name> <target-server>`	ផ្លាស់ទី profile Online ពិតប្រាកដ ដោយមាន confirmation/rollback។
`performance/movement/broadcasts/spoof <server> <on\|off>`	បើក/បិទ performance mode, movement, join/quit broadcasts ឬ spoofing។
`queue <server> <step> <join-seconds> <quit-seconds>`	កំណត់ល្បឿន queue។
`doctor/sync/save/reload <server>`	ពិនិត្យ, sync snapshot, save ឬ reload Backend។
`remove <server> <name>`, `info <name>`, `profiles [server]`	លុប profile, មើលព័ត៌មាន និងបញ្ជី profiles។

Alias និង command availability អាចខុសតាម platform/build។ ប្រើ help ដែលចេញពី JAR ជាក់ស្ដែងរបស់អ្នកជាប្រភពចុងក្រោយ។

៧. Permission និង PlaceholderAPI

Permission admin៖ dynafakeplayer.admin។ នៅ Bukkit/Paper ជាទូទៅ Operator មានសិទ្ធិតាម default; នៅ Proxy ត្រូវផ្ដល់សិទ្ធិជាក់លាក់តាមប្រព័ន្ធ permission របស់អ្នក។
ប្រើ `/dfp permission <name> add <node>` ដើម្បីផ្ដល់ permission ចាំបាច់ឱ្យ profile។ រក្សា `compatibility.fake-players-op: false` ដើម្បីកុំឱ្យ fake profile ទទួល OP ដោយស្វ័យប្រវត្តិ។
PlaceholderAPI: `%dynafakeplayer_fakeplayers%`, `%dynafakeplayer_fake_online%`, `%dynafakeplayer_realplayers%`, `%dynafakeplayer_real_online%`, `%dynafakeplayer_totalplayers%`, `%dynafakeplayer_total_online%`, `%dynafakeplayer_online%`, `%dynafakeplayer_profiles%`, `%dynafakeplayer_multiplier%`។

៨. My Licenses — Reset និង Replace Key

Download plugin: ទាញយក JAR ដែលបានភ្ជាប់នឹង License របស់អ្នក។
Reset bindings: លុប bindings ចាស់ទាំងអស់ ដើម្បីឱ្យ Server ចុះឈ្មោះឡើងវិញ។ ត្រូវរង់ចាំ cooldown ដែលបង្ហាញលើ Panel។
Replace license key: ប្រើពេលសង្ស័យថា Key លេចធ្លាយ។ វាធ្វើឱ្យ Key ចាស់មិនអាចប្រើបាន ហើយបង្កើត Key ថ្មី។ បញ្ចូលពាក្យ `ROTATE` ដើម្បីបញ្ជាក់ បន្ទាប់មក update config នៅ Proxy និង Backend ទាំងអស់ ហើយ restart។
Online status: បង្ហាញ Online តែពេល License សកម្ម និង heartbeat ថ្មីៗទើបមកដល់។ Server offline, network blocked ឬ License API មិនអាចទាក់ទងបាន អាចបង្ហាញ Offline/0។

៩. Troubleshooting

License required/invalid: ពិនិត្យ Key ក្នុង config, ស្ថានភាព License ក្នុង My Licenses និងការតភ្ជាប់ HTTPS ទៅ License API។
Proxy/Backend = 0: ពិនិត្យ server name, shared sync token, firewall/port, version compatibility និង log របស់ Proxy/Backend។ ត្រូវឱ្យ heartbeat បានជោគជ័យមុន Online count បង្ហាញ។
Paid but no license: កុំទិញម្ដងទៀត។ ពិនិត្យ Order history និងស្ថានភាព PAID/PROVISION_FAILED រួចទាក់ទង Admin ជាមួយ Order ID (កុំផ្ញើ password ឬ secret)។
Commands not found: អ្នកប្រហែលកំពុងប្រើ command prefix/platform ខុស ឬ JAR មិនត្រូវនឹង server software។
ប្រើ `/dfp exportdebug` សម្រាប់ report; ពិនិត្យ console logs។ ពិនិត្យមុនផ្ញើ report ហើយកុំបង្ហោះ token, full license key, sync token ឬ config secrets។

1. Before installing

Use the Java version required by your Minecraft/server software; the reviewed owner source recommends Java 21.
Have one proxy (Velocity or BungeeCord/Waterfall) and your Paper backends connected as a network.
Purchase a license or use one granted by the administrator. Never share your license key, config, sync.properties, or sync.token.
Stop the server before adding/removing the plugin. Do not use Bukkit `/reload` or proxy hot-reloaders.

2. Create an account and claim your free license

Register with your email and complete email verification if prompted.
Sign in, open My Licenses, and press Claim Free License while the two-month promotion is active. No payment or payment information is required.
The server creates a real license through the existing LicenseService. Your key and Download plugin button appear in your private account after successful issuance.
The current product allowance is up to 3 proxy activations and 6 backend activations. Online counts can differ from bound/used counts.

3. Install on a proxy (Velocity / BungeeCord / Waterfall)

Download the JAR from My licenses → Download plugin.
Put the platform-compatible JAR in the proxy's `plugins/` folder. Make sure the build supports your specific proxy.
Start the proxy once to generate configuration, then stop it before editing.
Replace `NONE` with your real license key. Keep the config private.
Start again. The plugin creates `sync.properties` and `sync.token`; keep these secret.
Check `/vdfp status` on Velocity or `/bdfp status` on BungeeCord/Waterfall.

4. Install on Paper backends

Put the Paper/Bukkit-compatible JAR in each backend's `plugins/` folder and start once to generate config.
Stop the backend and set the license key as required by the exact release. Use the same license key for this license, but never publish it.
Copy the `sync.token` value from the proxy's `sync.properties` into `proxy-sync.token` in every backend config.
Set a unique `proxy-sync.server-name` for each backend, matching the name used by the proxy.
If backends are on other machines, configure bind host/port as described in that release and firewall the port to trusted machines only.
Restart all proxy/backend servers. Check `/dfp status`, `/dfp network`, and `/vdfp status` or `/bdfp status`.

Config paths and option names can differ between builds. Follow the README/INSTALLATION shipped with your downloaded JAR; do not mix configs from different releases without comparing them.

5. Backend / Paper commands

Command	Purpose
`/dfp help`	Show command help.
`/dfp status`	Show targets, profiles, bridge and sync health.
`/dfp doctor [repair\|all]`	Inspect registrations and retry/rebuild missing entries.
`/dfp gui [page]`	Open administration GUI.
`/dfp compatibility`	Show compatibility adapters.
`/dfp network`	Show proxy/backend sync health.
`/dfp benchmark`	Measure runtime cost.
`/dfp exportdebug`	Write a diagnostic report with secrets omitted.
`/dfp rejoin <name\|all>`	Release quarantined identities after kick/disconnect.
`/dfp toggle`	Enable/disable automatic spoofing.
`/dfp set <amount\|-1>`	Set target; `-1` selects multiplier/fluctuation mode.
`/dfp multiplier <value>`	Set multiplier of 1.0 or greater.
`/dfp profiles generate <amount>`	Generate saved profile identities.
`/dfp profiles list`	List profiles and online state.
`/dfp profiles clear`	Remove all saved profiles.
`/dfp spawn <name>`	Bring a profile online manually.
`/dfp despawn <name\|all>`	Take one or all profiles offline.
`/dfp remove <name>`	Delete a saved profile.
`/dfp skin <name> <skin-owner>`	Resolve and apply a Minecraft skin.
`/dfp skins status`	Show resolved skin totals.
`/dfp skins refresh`	Refresh cached skins.
`/dfp ping <name> <0-60000>`	Set simulated latency in milliseconds.
`/dfp chat <name> <message>`	Send chat through the configured fake-player path.
`/dfp sudo <name> <command>`	Run a command as the native fake player.
`/dfp persist <name> <true\|false>`	Set whether a manual profile returns after restart.
`/dfp behavior <name> <group>`	Set passive/wander/follower/aggressive/afk behavior.
`/dfp gamemode <name> <mode>`	Set survival/creative/adventure/spectator.
`/dfp item <name> <material>`	Set main-hand material.
`/dfp equipment <name> <slot> <material>`	Set mainhand/offhand/helmet/chestplate/leggings/boots.
`/dfp permission <name> list`	List profile permission nodes.
`/dfp permission <name> <add\|remove> <node>`	Add/remove a profile permission node.
`/dfp info <name>`	Show persistent profile state.
`/dfp reload`	Reload config and runtime adapters.
`/dfp save`	Queue an immediate profile save.

6. Proxy commands

Use `/vdfp` on Velocity and `/bdfp` on BungeeCord/Waterfall. Most commands target a backend by its configured server name.

Command pattern	Purpose
`/vdfp status` / `/bdfp status`	Show snapshots, transports, queues and native registry state.
`/vdfp repair`	Retry Velocity registry bridge.
`/vdfp set <server> <amount\|-1>`	Set target for a backend.
`/vdfp multiplier <server> <value>`	Set backend multiplier.
`/vdfp spawn <server> <name>` / `despawn <server> <name\|all>`	Spawn/despawn profiles on a selected backend.
`persist/chat/sudo/skin/ping/behavior/gamemode/item/equipment/permission <server> ...`	Manage profile state and actions; use the exact subcommand arguments shown by your build's help.
`server <server> <name> <assigned-server>`	Change stored assignment metadata only.
`move <name> <target-server>`	Move an online profile with confirmation/rollback.
`performance/movement/broadcasts/spoof <server> <on\|off>`	Toggle backend performance, movement, join/quit broadcasts or spoofing.
`queue <server> <step> <join-seconds> <quit-seconds>`	Set target queue pacing.
`doctor/sync/save/reload <server>`	Check, sync, save or reload a backend.
`remove <server> <name>`, `info <name>`, `profiles [server]`	Delete, inspect or list profiles.

Aliases and command availability vary by platform/build. Use help from the exact installed JAR as the final reference.

7. Permissions and PlaceholderAPI

Admin permission: dynafakeplayer.admin. On Bukkit/Paper, operators normally have access by default; on proxies, grant permissions explicitly through your permission system.
Use `/dfp permission <name> add <node>` to grant only needed permissions. Keep `compatibility.fake-players-op: false`.
PlaceholderAPI: `%dynafakeplayer_fakeplayers%`, `%dynafakeplayer_fake_online%`, `%dynafakeplayer_realplayers%`, `%dynafakeplayer_real_online%`, `%dynafakeplayer_totalplayers%`, `%dynafakeplayer_total_online%`, `%dynafakeplayer_online%`, `%dynafakeplayer_profiles%`, `%dynafakeplayer_multiplier%`.

8. My Licenses: reset and replace key

Download plugin: download the JAR linked to your license.
Reset bindings: clear existing bindings so servers can activate again. Respect the cooldown shown on the panel.
Replace license key: use if the key may have leaked. The old key is invalidated and a new one is issued. Type `ROTATE`, then update every proxy/backend config and restart all servers.
Online status: requires an active license and a recent heartbeat. Offline servers, blocked networking, or an unreachable license API may show Offline/0.

9. Troubleshooting

License required/invalid: check the configured key, license status in My Licenses, and HTTPS access to the license API.
Proxy/Backend = 0: verify server names, shared sync token, firewall/port, platform compatibility and proxy/backend logs. Heartbeats must succeed before online counts rise.
Paid but no license: do not buy again. Check Order history and PAID/PROVISION_FAILED status, then contact the administrator with the Order ID. Never send passwords or secrets.
Unknown command: check the command prefix/platform and confirm that the JAR matches your server software.
Use `/dfp exportdebug` and console logs. Remove tokens, full license keys, sync tokens and secrets before sharing any report.