i just fixed an exception bug. but, i really dont know why i put 5.6 instead of 3.6. i think were in future now. jave fun

🌙 FoliaCore v-3.3 - Dark Angel

The shadow guardian's edge. v-3.3 brings player-controlled display toggles to Dark Angels everywhere.

✨ What's New

Scoreboard Toggle System (NEW)

• Players can now toggle their scoreboard/sidebar visibility on/off
• Command: /scoreboard or /sidebar - toggles display with permission foliacore.scoreboard.toggle
• Perfect for players who want minimal UI or different display preferences
• Default: Scoreboard visible - players can hide if desired

Command Additions

• /scoreboard toggle - Toggle your scoreboard visibility
• /sidebar toggle - Alias for scoreboard toggle command
• Permission: foliacore.scoreboard.toggle

🏗️ Technical Improvements

New Classes

• ScoreboardToggleCommand: Manages player-level scoreboard toggle state
  • Thread-safe toggle management with UUID-based state tracking
  • Per-player visibility preferences persist across sessions
  • Clean integration with existing DisplayManager infrastructure

Configuration Changes

• No config changes required - uses default scoreboard enabled state
• Players override via command preference

Code Updates

• Updated version to v-3.3-Dark-Angel across:
  • pom.xml (artifact version)
  • paper-plugin.yml (plugin version)
  • FoliaCore.java (version branding in startup banner)

📋 Installation

1. Download: Build with Java 21 using Maven: mvn clean package

   • IMPORTANT: Requires Java 21+ for compilation (uses Java 21+ language features)
   • Runs on Paper/Folia 1.21.x servers

2. Install: Copy folia_core-v-3.3-Dark-Angel.jar to your plugins/ folder

3. Reload: Run /reload confirm or restart your server

4. Use: Players can now:

   • /scoreboard - toggle sidebar on/off
   • /sidebar - alias for scoreboard toggle

📁 Configuration Files

Required Files

• config.yml - Main configuration (enable/disable systems, customize messages)
• tab-sidebar.yml - Visual system blueprint (tab lists, sidebars, nametags, bossbar, database settings)
• security.yml - Ban/mute/block data persistence
• kits.yml - Kit definitions and rewards
• warps.yml - Warp locations
• markers.yml - Marker data
• team_data.yml - Team system data
• chat_data.yml - Chat history and social data
• autobroadcasts.yml - Auto-broadcast message rotation

🎮 Key Commands

All commands support aliases and permission-based access control:

# Scoreboard Control (NEW)
/scoreboard             - Toggle your sidebar visibility
/sidebar                - Alias for /scoreboard

# Player Commands
/fly, /god, /heal, /feed, /gamemode, /gms/gmc/gma/gmsp
/home, /sethome, /delhome, /homes
/warp, /setwarp, /delwarp, /warps
/tpa, /tpahere, /tpaccept, /tpdeny, /tp, /back

# Social Commands
/msg <player>, /reply, /block, /unblock, /mail

# Staff Commands
/vanish, /socialspy, /staffchat, /sc
/mute, /unmute, /ban, /tempban, /unban, /kick
/antiraid, /broadcast

# Utility Commands
/kit, /marker, /gps, /calc, /status, /ping
/time, /weather, /clear, /clearhat, /repair
/enderchest, /invsee, /trash, /workbench

📊 Metrics

bStats Integration enabled by default (Plugin ID: 28430)

View plugin statistics at: https://bstats.org/plugin/bukkit/FoliaCore/28430

🔧 Upgrading from v-3.2

• [IMPORTANT] Requires Java 21+ to compile
• New command: /scoreboard and /sidebar are now available
• No breaking changes to existing features
• Default scoreboard state: visible (players can toggle off)
• All existing configs remain compatible

🐛 Known Limitations

• Scoreboard toggle persistence is per-session (resets on server restart)
  • Can be upgraded to use database in future versions
• Toggle applies to Bukkit scoreboards only (not Adventure components)

🤝 Support & Issues

• GitHub: https://github.com/AJARETRO/FoliaCore
• Modrinth: /plugins/FoliaCore
• Report issues: https://github.com/AJARETRO/FoliaCore/issues

📝 Full Feature Set

10 Modular Systems

1. Chat System - Muting, blocking, mail, custom channels
2. Teleportation - Homes, warps, TPA with accepts/denies
3. Teams - Multi-player team management with team chat
4. Kits - Reward kits with GUI and cooldowns
5. Utility - Markers, GPS, warp system, calculation
6. Tab Display - Animated header/footer, sorting, objectives
7. Sidebar - Animated scoreboard with multiple layouts
8. Staff Tools - Vanish, social spy, staff chat, punishment system
9. System - Status monitoring, performance tracking, auto-broadcasts
10. Anti-Raid/Security - Rate limiting, ban/mute/block system

Visual Blueprint (tab-sidebar.yml)

• Multi-database support (MySQL with connection pooling)
• Per-system animation intervals
• Conditional placeholder syntax (if_ping_>100%)
• Sidebar layouts (default 15-line, flickerless rendering)
• Nametag, belowname, bossbar, ping spoof configurations
• Multiserver support (Bungee/Velocity with proxy placeholders)
• Custom fonts and sprite textures

Version: v-3.3-Dark-Angel Build Date: May 11, 2026 Java Version: 21+ (required for compilation) Paper Version: 1.21.x+ License: GNU General Public License v3.0

New in this build Added /calc command for inline math expressions (example: /calc 10*4). Added animated tab system with configurable method names and frame lists. Added animated sidebar system with configurable method names and frame lists. Added optional PlaceholderAPI support for tab and sidebar placeholders. Added /trash and /dispose commands for quick inventory disposal. Added /repair [all] and /repair [all] for admin QoL. Added MODRINTH.md with English plain-text project description. Revamped README for Nightingale configuration and usage. Tab and Sidebar Config Model Methods are fully configurable by name. Each method is a frame sequence (one line per frame). Header/footer and sidebar title/lines reference method names. Frames cycle automatically using configured tick intervals. Runtime Java 21+ Folia 26.1.2+

FoliaCore v2.6.1 Hotfix - Overdrive Overhauled Fixed Vault is now optional at startup instead of crashing when the Vault API class is missing Economy registration is wrapped defensively so FoliaCore boots cleanly without Vault installed Included Async Modrinth update checker remains active Op-only login update prompt still points to the Modrinth project page Startup banner and README branding updated to the hotfix release name Notes Version: v2.6.1-hotfix Modrinth project: /plugins/foliacore bStats plugin ID: 28430 Target: Folia 26.1.2+ and Java 21+

FoliaCore v2.6 Overhauled-Overdrive What changed Added Modrinth update checking through the Folia async scheduler Ops now receive an in-game update prompt with the Modrinth project link on login Startup output now shows the new v2.6 Overhauled-Overdrive branding README branding and release references were updated to match the new version Modrinth integration Project slug: foliacore Update URL: https://api.modrinth.com/v2/project/foliacore/version Project link: /plugins/foliacore

Included in this release Folia-safe async update checker Op-only login notification with update link Shaded jar artifact for direct server use bStats integration remains enabled with plugin ID 28430 Notes FoliaCore continues to target Folia 26.1.2+ and Java 21+ with a modular, region-aware architecture.