Antone Barbaud
84735221f1
Package restructure to prepare future modularization. Three layers now:
1. fr.luc.crcore.util.* (always active)
- common, command framework, database, message, broadcast, gui,
placeholder
2. fr.luc.crcore.features.* (opt-in)
- team (entities, services, repos, events, exceptions, config + GUI,
command/Team*SubCommand)
- player (profile, ranking, services, repos, events, exceptions)
3. fr.luc.crcore.builtin.*
- CoreCommand + CoreReloadSubCommand (top-level routing — not a
feature, not an util)
FQN moves (game plugins importing these need their imports updated):
- fr.luc.crcore.common.* → fr.luc.crcore.util.common.*
- fr.luc.crcore.command.* → fr.luc.crcore.util.command.*
- fr.luc.crcore.command.builtin.team.*
→ fr.luc.crcore.features.team.command.*
- fr.luc.crcore.command.builtin.CoreCommand / CoreReloadSubCommand
→ fr.luc.crcore.builtin.*
- fr.luc.crcore.database.* → fr.luc.crcore.util.database.*
- fr.luc.crcore.message.* → fr.luc.crcore.util.message.*
- fr.luc.crcore.broadcast.* → fr.luc.crcore.util.broadcast.*
- fr.luc.crcore.gui.* → fr.luc.crcore.util.gui.*
- fr.luc.crcore.placeholder.* → fr.luc.crcore.util.placeholder.*
- fr.luc.crcore.team.* → fr.luc.crcore.features.team.*
- fr.luc.crcore.player.* → fr.luc.crcore.features.player.*
CRCoreConfig — features opt-in via fluent setup:
- setupTeams() enables team feature
- setupPlayers() enables player feature
- setupPlaceholders() enables PAPI integration
- setupAll() shortcut
By default no feature is active. Game plugin must opt-in.
CRCore.enable() now conditional:
- Util services always built (messages, broadcasts, gui listener).
- Team services + repos + config built only if setupTeams().
- Player services + repos built only if setupPlayers().
- Placeholder hook registered only if setupPlaceholders() (and PAPI
installed at runtime).
- Getters of disabled features throw IllegalStateException with a clear
message pointing to the missing setupX() call.
- CoreCommand only registers TeamGroupSubCommand if teamService and
teamConfig are non-null. CoreReloadSubCommand handles teamConfig=null
(just skips that reload). /core reload always available.
Docs:
- setup.md tree fully rewritten to reflect util/+features/+builtin
layout (~70 lines of arborescence).
- setup.md code snippet shows the three opt-in patterns (setupAll /
granular / with options).
- decisions.md logs both decisions (restructure + modular setup).
- All .puml diagrams auto-updated to new FQNs.
Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
83 lines
2.2 KiB
Plaintext
83 lines
2.2 KiB
Plaintext
@startuml gui-class-diagram
|
|
title CR-Core — GUI framework (class diagram, réutilisable)
|
|
|
|
skinparam classAttributeIconSize 0
|
|
hide empty members
|
|
|
|
package "fr.luc.crcore.util.gui" {
|
|
|
|
abstract class AbstractInventoryGui {
|
|
- inventory: Inventory
|
|
- handlers: Map<Integer, GuiClickHandler>
|
|
--
|
|
# setInventory(Inventory): void
|
|
+ getInventory(): Inventory
|
|
+ {abstract} rebuild(): void
|
|
+ onClose(HumanEntity): void
|
|
+ openTo(HumanEntity): void
|
|
# setButton(slot, item, handler): void
|
|
# setDecoration(slot, item): void
|
|
# clearSlot(slot): void
|
|
+ handleClick(event): void ' appelé par GuiListener
|
|
+ handleClose(event): void
|
|
}
|
|
AbstractInventoryGui ..|> "org.bukkit.inventory.InventoryHolder"
|
|
|
|
interface GuiClickHandler <<FunctionalInterface>> {
|
|
+ onClick(InventoryClickEvent): void
|
|
}
|
|
|
|
class GuiListener {
|
|
+ registerOn(JavaPlugin): void
|
|
--
|
|
@ onClick(InventoryClickEvent)
|
|
@ onClose(InventoryCloseEvent)
|
|
}
|
|
GuiListener ..|> "org.bukkit.event.Listener"
|
|
|
|
class GuiItems <<utility>> {
|
|
+ {static} named(material, name): Builder
|
|
+ {static} of(material): Builder
|
|
+ {static} filler(): ItemStack
|
|
+ {static} item(builder): ItemStack
|
|
}
|
|
|
|
class "GuiItems.Builder" as Builder {
|
|
- stack: ItemStack
|
|
- meta: ItemMeta
|
|
+ name(text): Builder
|
|
+ lore(lines...): Builder
|
|
+ lore(List<String>): Builder
|
|
+ amount(int): Builder
|
|
+ build(): ItemStack
|
|
+ asItem(): ItemStack
|
|
}
|
|
GuiItems +-- Builder
|
|
|
|
GuiListener ..> AbstractInventoryGui : dispatches via getHolder()
|
|
AbstractInventoryGui --> GuiClickHandler : per-slot
|
|
}
|
|
|
|
note right of GuiListener
|
|
Détection par holder :
|
|
if (e.getInventory().getHolder()
|
|
instanceof AbstractInventoryGui gui) {
|
|
e.setCancelled(true); // ← TOUJOURS, même slot vide
|
|
gui.handleClick(e);
|
|
}
|
|
|
|
Enregistré une fois dans CRCore.enable().
|
|
end note
|
|
|
|
note right of AbstractInventoryGui
|
|
Pattern :
|
|
1. extends AbstractInventoryGui
|
|
2. constructeur :
|
|
Inventory inv = Bukkit.createInventory(this, 27, "&eTitre");
|
|
setInventory(inv);
|
|
3. override rebuild() pour peindre
|
|
4. setButton(slot, GuiItems.named(...).build(), handler)
|
|
end note
|
|
|
|
@enduml
|