🌙 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