Antone Barbaud
75d2fa866d
New fr.luc.crcore.team.config module: - TeamSetting<T> (typed, with key/type/default/parser/serializer; factories ofBoolean/ofInt/ofString/ofEnum). - TeamSettings registry: 8 standard settings (FRIENDLY_FIRE, PVP_PROTECTION_SECONDS, MAX_SIZE, MIN_SIZE, RESPAWN_AT_TEAM_SPAWN, TEAM_CHAT_ENABLED, SHOW_TAG_ABOVE_HEAD, TEAM_COLOR_IN_NAME), extensible via register() for game plugins. - TeamConfigService interface with cascade get(team, setting) → per-team override (SQLite) → global YAML → hard default. Persists per- team via TeamRepository.save(), global via YamlConfiguration.save(). - YamlTeamConfigService default impl with bundled crcore-team-config.yml. Storage: - Team.getSettings() Map<String, Object> for per-team overrides. - New SQLite table crcore_team_settings (team_id, key, value, type) with load + write-through persist in SqliteTeamRepository. - Global YAML <plugin>-team-config.yml in dataFolder, auto-created at first boot (template from game plugin's resource of the same name takes priority). New reusable GUI framework fr.luc.crcore.gui: - AbstractInventoryGui (implements InventoryHolder, rebuild() abstract, setButton/setDecoration/clearSlot helpers, onClose hook, openTo()). - GuiClickHandler FunctionalInterface. - GuiListener (single Bukkit listener, detects via getHolder(), ALWAYS cancels clicks even on slots without handlers). - GuiItems builder (named/of/filler + lore/amount/build, '&' color codes translated). Concrete settings GUIs (fr.luc.crcore.team.config.gui): - AbstractSettingsGui base renderer: 27 slots, settings in row 2, booleans = LIME_DYE / GRAY_DYE toggle, integers = BOOK with left +1 / right -1 (shift × 10), strings/enums display-only. - GlobalSettingsGui: writes to YAML on each change. - TeamSettingsGui: writes to per-team overrides, "override active" flag in lore when value differs from global, "Reset all overrides" footer button. New /core team settings [team] subcommand: - No arg → GlobalSettingsGui (perm crcore.team.settings.global). - With arg → TeamSettingsGui (perm crcore.team.settings). - Player-only (Bukkit needs HumanEntity to open inventory). - Lives under /core team to stay modular (objective: split into modules later; everything team-related under /core team). CRCore: buildTeamConfigService() override point, teamConfig()/getTeamConfig() getters, GuiListener.registerOn(plugin) at enable(). CoreCommand, TeamGroupSubCommand and CoreReloadSubCommand extended to receive TeamConfigService. /core reload now reloads messages + broadcasts + team-config. Docs: new section 10 "Paramètres d'équipe", new decisions logged, setup.md tree updated, two new diagrams (team-config + gui). 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.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
|