docs: Add punishment API and some disclaimers for FancyCore

docs/src/fancycore/api/events.md

@@ -3,7 +3,7 @@ icon: dot
 order: 9
 ---
 
-# Events
+# Events API
 
 FancyCore has its own event system that allows you to listen to various events that happen in the FancyCore system.
 

docs/src/fancycore/api/punishments.md

@@ -0,0 +1,38 @@
+---
+icon: dot
+order: 8
+---
+
+# Punishment API
+
+FancyCore provides a comprehensive Punishment API that allows you to manage player punishments such as warnings, kicks, mutes, and bans.
+
+## Using the Punishment Service
+
+With the Punishment Service, you can easily issue various types of punishments to players. Below are examples of how to use the Punishment Service:
+
+```java
+PunishmentService punishmentService = FancyCore.get().getPunishmentService();
+
+punishmentService.warnPlayer(player, staff, "reason", duration);
+
+punishmentService.mutePlayer(player, staff, "reason"); // Permanent mute
+punishmentService.mutePlayer(player, staff, "reason", 1000*60*60*4); // Temporary mute (4 hours)
+
+punishmentService.kickPlayer(player, staff, "reason");
+
+punishmentService.banPlayer(player, staff, "reason", duration); // Permanent ban
+punishmentService.banPlayer(player, staff, "reason", 1000*60*60*24); // Temporary ban (1 day)
+```
+
+You can also retrieve existing punishments for a player:
+
+```java
+List<Punishment> punishments = punishmentService.getPunishmentsForPlayer(player);
+```
+
+Player reports are also managed through the Punishment Service:
+
+```java
+punishmentService.reportPlayer(player, staff, "reason");
+```

docs/src/fancycore/commands/chat.md

@@ -7,6 +7,11 @@ title: Chat
 
 # Commands for the chat system
 
+!!!warning
+The command list is not complete and not all commands are properly documented yet.
+Some commands might not be implemented yet.
+!!!
+
 ## Messages
 
 ### Message

docs/src/fancycore/commands/economy.md

@@ -7,6 +7,11 @@ title: Economy
 
 # Commands for the economy system
 
+!!!warning
+The command list is not complete and not all commands are properly documented yet.
+Some commands might not be implemented yet.
+!!!
+
 ### Balance
 
 Description: Displays the balance of the specified player or your own balance if no player is specified.<br/>

docs/src/fancycore/commands/inventory.md

@@ -7,6 +7,11 @@ title: Inventory
 
 # Commands for the inventory system
 
+!!!warning
+The command list is not complete and not all commands are properly documented yet.
+Some commands might not be implemented yet.
+!!!
+
 ## Kits
 
 ### Create Kit

docs/src/fancycore/commands/moderation.md

@@ -7,6 +7,11 @@ title: Moderation
 
 # Commands for the moderation system
 
+!!!warning
+The command list is not complete and not all commands are properly documented yet.
+Some commands might not be implemented yet.
+!!!
+
 ## Report
 
 ### Report a Player

docs/src/fancycore/commands/permissions.md

@@ -7,6 +7,11 @@ title: Permissions
 
 # Commands for the permissions system
 
+!!!warning
+The command list is not complete and not all commands are properly documented yet.
+Some commands might not be implemented yet.
+!!!
+
 ## Groups
 
 ### Create Group

docs/src/fancycore/commands/player.md

@@ -7,6 +7,11 @@ title: Player
 
 # Commands for the player system
 
+!!!warning
+The command list is not complete and not all commands are properly documented yet.
+Some commands might not be implemented yet.
+!!!
+
 ### Gamemode
 
 Description: Changes the gamemode of a player.<br/>

docs/src/fancycore/commands/server.md

@@ -7,6 +7,11 @@ title: Server
 
 # Commands for the server system
 
+!!!warning
+The command list is not complete and not all commands are properly documented yet.
+Some commands might not be implemented yet.
+!!!
+
 ## Server control
 
 ### Restart

docs/src/fancycore/commands/teleportation.md

@@ -7,6 +7,11 @@ title: Teleportation
 
 # Commands for the teleportation system
 
+!!!warning
+The command list is not complete and not all commands are properly documented yet.
+Some commands might not be implemented yet.
+!!!
+
 ## Player Teleportation
 
 ### Teleport to another player

docs/src/fancycore/commands/world.md

@@ -7,6 +7,11 @@ title: World
 
 # Commands for the world management system
 
+!!!warning
+The command list is not complete and not all commands are properly documented yet.
+Some commands might not be implemented yet.
+!!!
+
 ## World Management
 
 ### Create a new world