ChaosPVP

# ChaosPVP A PVP plugin with 16 unique character classes for Minecraft Paper 1.21.11 servers. ## Features - 16 Unique Professions: Inspector, Scientist, Plaguebringer, Shield Soldier, Critical Cutter, Navigator, Captain, Creature, Juggler, Dragonwrath, Undead, Stamper, Time Marker, Horseman, Vitality Cutter, Marathoner - Class-Specific Abilities: Each class has unique items, abilities, and passive effects - Resource Collection System: Collect resources to unlock powerful ultimate abilities (Swordsman, Scientist, etc.) - Cooldown Management: Balanced ability cooldowns displayed via action bar and chat - Team & Solo Modes: Supports both draft pick team mode and solo free-for-all - Practice Mode: Test classes individually for 5 minutes (same mechanics as real game) - Auto-Save Data: All map and lobby settings are automatically saved in real-time - Game Duration: 10-minute matches ## Class Overview ### Swordsman A melee combat specialist using various swords. - Passive: +1 bonus damage with stone sword attacks - Diamond Sword: Right-click for forward attack - 8 damage (4 hearts), 12.5s cooldown, grants netherite scrap on hit - Ultimate: Netherite Sword - 4 base + 16 instant damage (collect 3 netherite scraps, max 1, single use) ### Scientist A support class with random potion abilities and mobility. - Passive: Speed I (0.5s) when throwing items - Ability: Generate random splash potion every 7.5s (max 3) - Ultimate: Lingering area potion - 7 block diameter, 8s duration, heals self + damages enemies (collect 9 ultimate materials) ### Plague Spreader Controls areas with poison immunity and toxic fields. - Passive: Immune to poison damage - Poison Engine: Generated every 20s (max 2), creates poison field for 10s (6 block diameter) - Extreme Poison Engine: Generated every 100s (max 1), creates enhanced poison field for 10s (8 block diameter) - Special: Speed buff in field, instant damage + weakness + poison to enemies ### Shield Soldier A tank class with defensive abilities and absorption mechanics. - Passive: Gain 2 absorption hearts after 12s without taking damage (lasts 60s) - Red Shield: Deal 6 damage to attacker when blocking, 6s cooldown - Blue Shield: Gain 2 absorption hearts when blocking (lasts 10s), 11s cooldown - Basic Shield: Apply weakness I (1.5s) to attacker when blocking, 4s cooldown - Golden Shield: Auto-obtained at 12 HP or below, grants strength II + speed I + 6 absorption hearts (8s) when blocking, single use ### Critical Cutter A burst damage class with escalating critical hit mechanics. - Passive: 5% base critical chance (increases by 1% per non-critical hit) - Weapon: Critical Cutter Sword (5.0 damage = 2.5 hearts, same as stone sword) - Special: Critical hits deal 2x damage + heal 2 HP (1 heart) - Guaranteed Critical: Right-click for forward attack - 6 base + 6 instant damage + heal 6 HP, 25s cooldown ### Navigator A mobility class specialized in knockback and position control. - Passive: Knockback I on sword - Naval Weapon: Generated every 20s (max 3, durability 1) - 1 base + 4 instant damage, knockback II - Wave Riding: Speed IV (1s), knockback + slowness V (1s) on collision, 12s cooldown - Harpoon Throw: 6 damage + slowness V (1s), 15s cooldown (50% reduction on miss) ### Captain A team supporter who strengthens and assists teammates. - Passive: Grant random teammate strength I (2s) when attacking enemies (self in solo mode) - Captain's Command: Give teammates naval weapon + strength I (5s), 15s cooldown - Captain's Harpoon: 4 damage, on hit: teammates get strength I (3s) + enemy gets weakness I (3s) + 3s cooldown reduction, 9s cooldown ### Shapeshifter A transformation class that evolves over time. - Evolution Stages: Ocelot (0-1min) → Cow (1-2min) → Sniffer (2-4min) → Ravager (4min+) - Ocelot: 5 hearts, speed III, weakness III - Cow: 15 hearts, regenerate 1 heart every 3s, stone sword - Sniffer: 25 hearts, resistance I, iron sword - Ravager: 35 hearts, resistance II, strength I - Charge: Available at all stages - speed V (0.4s), slowness V (0.5s) on collision, 7s cooldown ### Juggler A throwing specialist using various projectiles. - Passive: No stone sword at start, gain 1 "Throw Time" every 60s (max 1) - Light Thing: Throw snowball - 1 damage (0.5 hearts), no knockback, 4s cooldown (resets on hit) - Heavy Thing: Throw wind charge - 8 damage (4 hearts), slowness V (1s) + blindness (1s), 13s cooldown - Throw Time: Slowness V (2.5s) to all enemies within 10 blocks + reset light thing cooldown (consumable) ### Dragon Fury A class that collects fury to unleash powerful counterattacks. - Passive: +1 fury when taking damage (max 30), auto-generate +1 every 8s - Resistance by Fury: 0-10 fury = resistance I, 11-20 = resistance II, 21-30 = resistance III - Fury Counterattack: Deal damage equal to fury count to nearest enemy within 5 blocks, heal fury/2 HP on kill, 30s cooldown - Starting Items: Full iron armor set, permanent strength I + resistance I ### Undead A special class that overcomes death. - Passive: Instantly revive on first death (once per game) - Revival Effect: Revive with max health, gain speed I + strength II + resistance V - Revival Penalty: Take 1 damage (0.5 hearts) every 0.25s starting 3s after revival (until second death) ### Stamper A class specialized in aerial mobility and fall attacks. - Passive: No fall damage, deal 6 damage to enemies within 4 blocks when falling 3+ blocks (12 damage if hitbox overlaps) - Stamp: Right-click heavy core - launch 10 blocks high, 20s cooldown - Dive: Right-click heavy core - launch 40 blocks high, deal 16 damage to enemies within 20 blocks on landing (32 damage if hitbox overlaps), obtained every 200s (max 1, consumable) ### Time Engraver A class that manipulates time to control enemies. - Passive: Immune to slowness - Time Engraving: Completely freeze all enemies within 8 blocks for 2s + weakness I (1.5s), gain time capsules equal to hit count, 16s cooldown - Clockhand Piercing: Throw arrow - 6 damage (3 hearts), 8 damage (4 hearts) + darkness/blindness (3s) to slowed targets, 12s cooldown (1s during eternal clock) - Eternal Clock: Completely freeze all players and mobs for 8s + slowness V + darkness + blindness, freeze all projectiles (collect 7 time capsules, consumable) ### Cavalry A mobile class that rides a horse and roams the battlefield. - **Passive**: Permanent Slow I Effect - **Horseback & Hippocampus**: Summons a horse (shares health with the player). When mounted, restores 6 health (3 hearts), 22-second cooldown - **Sweep**: Attacks a 3-block area in front - deals 6 damage (8 damage when mounted), 6-second cooldown (reduced by 1 second per hit, minimum 1 second) - **Special**: When a horse takes damage, the player also takes half damage. When the horse dies, the player is automatically eliminated. ### Marathoner An endurance class that increases speed by running. - **Passive**: 5 seconds of sprinting → Swiftness I, 3.5 seconds more → Swiftness II, 3.5 seconds more → Swiftness III, 3.5 seconds more → Swiftness IV + Strength II - **Passive Remove**: All buffs are removed upon stopping sprinting, taking damage, or jumping. - **Crouching Start**: Swiftness III (0.5 seconds), 5 second cooldown. ### Vitality Cutter A life-sucking class that drains the life of enemies. - **Passive**: No Stone Sword at start. - **Vitality Cutter**: Left-click attacks inflict 1/6 of the target's current health as instant damage. - **Life Drain**: Restores 1 HP (0.5 hearts) upon attack. - **Special**: In team battles, the passive is not applied when attacking a teammate. ## Installation 1. Download the latest release 2. Place the JAR file in your server's `plugins` folder 3. **Install Required Plugins**: - LibsDisguises (required for Shapeshifter class) - ProtocolLib (LibsDisguises dependency) 4. **Install Optional Plugins** (recommended): - Multiverse-Core (for automatic world reset after games) 5. Restart the server 6. Check settings in `plugins/ChaosPVP/data.yml` ## Commands ### Game Commands - `/게임시작` - Open class selection GUI - `/게임종료` - End game and reset all players (admin) - `/게임모드 <팀전|개인전>` - Set game mode (admin) ### Practice Mode - `/연습모드시작` - Start practice mode (class selection) - `/연습모드종료` - End practice mode - `/연습클래스` - Change class in practice mode - `/연습모드 맵 <맵이름>` - Set practice mode map (admin) - `/연습모드` - Teleport to practice mode map ### Map Management - `/로비` - Teleport to lobby - `/로비 지정` - Set current location as lobby (admin) - `/로비제거` - Remove lobby location (admin) - `/맵지정 [맵이름]` - Set map spawn location (admin) - `/맵제거 <번호>` - Remove map (admin) ### Player Management - `/인원제외 <플레이어명>` - Exclude player from game (admin) - `/인원추가 <플레이어명>` - Re-add excluded player (admin) ### Other - `/도움말` - Display help message - `/입자끄기` - Remove all poison fields (admin) - `/chaospvp` - ChaosPVP main command (aliases: /cpvp, /cp) ## Permissions - chaospvp.use - Allow basic command usage (default: true) - chaospvp.admin - Allow admin command usage (default: op) ## Requirements - Minecraft Server: Paper 1.21.11 - Java: 21 or higher - Required Plugins: - LibsDisguises (for Shapeshifter class) - ProtocolLib (LibsDisguises dependency) - Optional Plugins: - Multiverse-Core (for automatic world reset after games) ## Gameplay ### Starting a Game 1. Select mode with `/게임모드 팀전` or `/게임모드 개인전` 2. Start class selection with `/게임시작` 3. For team mode, select team in team selection GUI (draft pick system) 4. Game starts automatically when all players are ready ### During Game - Game duration: 10 minutes - Use each class's abilities to fight - Collect resources to unlock ultimate abilities - Last survivor or team wins ### Practice Mode - Start with `/연습모드시작` or `/연습모드` - Test classes individually - Same mechanics as real game - Change class anytime with `/연습클래스` - 5-minute cooldown (until next practice mode start) ## Development This plugin uses: - Paper API 1.21.11 - Minecraft server integration - LibsDisguises - Shapeshifter transformation feature - Gradle 8.5 - Build automation - Java 21 - Programming language - JUnit 5 - Unit testing framework - Mockito 5.8 - Mocking framework - jqwik 1.8 - Property-based testing ## Data Storage All map and lobby settings are automatically saved to `plugins/ChaosPVP/data.yml`. - Lobby location and name - General map list (locations and names) - Practice mode map (location and name) Settings are automatically saved in real-time when changed and automatically loaded on server restart. ## Balance Changes ### v3.0.2(Latest) ### Bug Fixes - **Fixed Swordsman Passive**: Fixed an issue where +1 additional damage was not applied to Stone Sword attacks. - Changed `ignoreCancelled = false` to apply to cancelled events. - Manually check whether an event was canceled to apply only to normal attacks. - **Fixed Critical Cutter Base Weapon Damage**: Fixed the base weapon to deal 5 damage instead of 6. - Use an Iron Sword, but manually set the damage to 5.0 (same as Stone Sword). - Additional damage is now applied immediately based on the adjusted 5.0 damage when a critical hit occurs. - **Default Game Mode Change**: Changed the default game mode from Team Match to Solo Match. - Fixed an issue where a team selection message would appear when starting Solo Match. - The Team Match Draft Pick system now functions properly. - **Fixed Practice Mode Death Handling**: Practice mode now automatically ends upon death. - **Fixed Sky Island Map Effect System**: - Set the time to 13000. Changed to Tick (Sunset/Twilight) - Completely remove lightning effects (user request) - Remove night vision effect particles (maintain effect, only hide particles) #### Features Added - **Sky Island Map Special Effects System**: - Fixed sunset/twilight time to 13000 ticks - Disabled rain/thunder weather - Automatically detects map names containing "Sky Island", "sky", or "skyisland" (case-insensitive) - **Setting a Single Spawn for a Map Slot**: - Existing spawn points are automatically deleted when `/setmap1` or `/setmap2` are executed. - The current location is automatically set to the map center and the first spawn point. - Additional spawn points can be added using `/addspawn1` or `/addspawn2`. - Added a notification message indicating the number of existing spawn points. ### v3.0 (Latest) - Bug Fix: Fixed OP permission not being restored after game end (removed duplicate OP save logic) - Bug Fix: Fixed practice mode items not being removed when starting game during practice mode - Bug Fix: Added random team assignment feature to team selection GUI ### v2.0 - Stamper: Stamp cooldown 12s → 20s - Stamper: Dive acquisition time 120s → 200s - Stamper: Stamp height 20 blocks → 10 blocks - Stamper: Dive height 80 blocks → 40 blocks - Stamper: Dive damage 12 (6 blocks) → 16 (8 blocks) - Stamper: Passive landing damage 4 (2 blocks) → 6 (3 blocks) - Stamper: Stamp item feather → heavy core - Time Engraver: Time engraving range 5 blocks → 8 blocks - Time Engraver: Time engraving slowness 1s → 2s (complete position freeze) - Time Engraver: Clockhand base damage 10 → 6 - Time Engraver: Clockhand bonus damage 6 → 8 - Time Engraver: Added clockhand piercing (arrow throw, darkness/blindness effect) - Time Engraver: Added complete position freeze to eternal clock - Navigator: Wave riding changed from complete position freeze → simple slowness V effect - Team Selection: Added draft pick system - Bug Fix: Fixed team glowing effect not being removed after game end - Bug Fix: Fixed team display errors ### v1.0 - Swordsman: Copper sword cooldown 15s → 24s, gold sword 14s → 22s, diamond sword 13s → 20s - Swordsman: Netherite sword limited to max 1 - Swordsman: Changed cooldown display from boss bar to chat - Critical Cutter: Fixed critical cutter sword damage (same as stone sword → 5.0 damage) - Critical Cutter: Guaranteed critical cooldown 6s → 25s - Shapeshifter: Added charge ability (all evolution stages) - Practice Mode: Redesigned with same mechanics as real game - Practice Mode: Return to practice map and auto-end on death ### Github https://github.com/Dangel165/ChaosPVP ## Credits - Plugin Development: Dangel - Map Creation: 145wir, ssadw1348, gyangsongsanghyeoninde,galaxy0596 - Balance Adjustment: 145wir - Planning: 145wir, ssadw1348