Summary
This update is focused on production stability, abuse prevention, cleaner moderation flow, and safer data persistence.
Most changes were made to reduce edge-case failures in real servers and make behavior more predictable for both staff and players.


What changed, why, and impact

1. Migrated to api-version 1.21 and Java 21 build
   - Why: Keep compatibility aligned with modern Paper runtime and tooling.
   - Impact: Better long-term compatibility, cleaner modern build path, fewer runtime mismatches in current server stacks.
   
2. Anti-abuse protections hardened for staff mode/vanish
   - Why: Prevent misuse while moderating (combat, interaction, block modify, item pickup), all configurable.
   - Impact: Lower abuse surface, safer staff operations, more controlled moderation sessions.
   
3. Freeze persistence and state flow improved
   - Why: Fix reconnect/state edge cases and keep freeze lifecycle consistent.
   - Impact: More reliable freeze behavior across disconnect/reconnect, fewer broken states.
   
4. Freeze chat and visual templates upgraded
   - Why: Improve communication clarity during active moderation.
   - Impact: Players get clearer instructions, staff sees cleaner structured information.
   
5. Fixed interaction lock after unfreeze
   - Why: Some players remained partially blocked after freeze removal.
   - Impact: Normal gameplay interaction is correctly restored after unfreeze.
   
6. Fixed freeze damage/attraction anomalies
   - Why: Prevent abuse and inconsistent entity/physics behavior while frozen.
   - Impact: Freeze sessions are cleaner and harder to exploit.
   
7. Stricter multi-language pipeline
   - Why: Avoid mixed-language output and keep language persistence stable.
   - Impact: More consistent translation output and better user-facing localization quality.
   
8. /staff help expanded and clarified
   - Why: Command discoverability and onboarding needed improvement.
   - Impact: Faster staff onboarding, fewer command errors, better in-game guidance.
   
9. Command autocomplete improved
   - Why: Improve usability for staff/sanctions/reports/xray command flows.
   - Impact: Faster execution, fewer syntax mistakes, smoother moderation rhythm.
   
10. Wiki and help texts updated
    - Why: Keep docs synchronized with real plugin behavior.
    - Impact: Lower setup confusion and fewer misconfigurations.
    
11. Internal listener refactor
    - Why: Reduce monolithic responsibilities and improve maintainability.
    - Impact: Cleaner architecture, easier future fixes/features, lower regression risk.
    
12. Async/batch persistence + crash-safe IO base
    - Why: Reduce sync write pressure and improve data safety on unexpected shutdown.
    - Impact: Better runtime performance profile and safer persistence model (temp + replace + recovery + optional backup).
    
13. /staff health diagnostic upgrade
    - Why: Improve observability for server owners and debugging workflows.
    - Impact: Faster troubleshooting and clearer technical status visibility.
    
14. Vanish/TAB desync fix
    - Why: Eliminate hard desynchronization issues reported in vanish visibility.
    - Impact: More stable visibility behavior between world view and tab list.
    
15. Final vanish behavior normalized (less aggressive)
    - Why: Previous strict mode could over-apply visibility and create side effects.
    - Impact: More predictable production behavior; avoids breaking TAB and general player visibility.

Operational notes

• This is still beta, but significantly more stable than previous builds.
• Recommended after update: full server restart (not only reload) for clean runtime state.
• If you use custom lang/config files, re-check new keys before going live.

If you report an issue, include:

• Server version
• Plugin version
• Reproduction steps
• Full console log/error

This beta focuses on stability, anti-abuse hardening, and workflow polish.

What’s improved:

• Vanish visibility logic reworked for safer behavior and cleaner tab synchronization.
• Freeze workflow refined:
  • Better command flow: /freeze <player> <reason> | /freeze <player> | /freeze claim <player>
  • Better freeze assignment continuity.
  • Better staff/player communication flow during active freeze.
• Anti-abuse behavior tightened for staff mode and vanish interaction policies.
• Language and help consistency pass completed:
  • /staff help refreshed.
  • Lang files aligned.
  • Wiki/help references updated.
• Documentation cleanup + EN/ES sync to match real plugin behavior.
• Build/version metadata updated to 1.2.0-beta.2.
• General internal cleanup and reliability improvements.

Notes:

• Tested on Paper 1.20.4 and updated codebase for 1.21 API target.
• This is still a beta build focused on real-world testing and feedback.

If you report an issue, include:

• Server version
• Plugin version
• Reproduction steps
• Full console error (if any)