Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
50 commits
Select commit Hold shift + click to select a range
463fb0c
fix: correct all code review blockers and finalize epics 1-7
Blushister Apr 9, 2026
c79ce8b
merge: codex/runtime-combat-tuning → master (épics 1-7 validés)
Blushister Apr 9, 2026
93ee7b6
refactor: migrate shared utilities to arcadia core
Blushister Apr 10, 2026
6eb7dab
feat: add arcadia progression profile
Blushister Apr 10, 2026
553e499
chore: tidy workspace artifacts
Blushister Apr 10, 2026
f1ddd5b
feat: add README.md for project documentation and setup instructions
N0tFond Apr 10, 2026
866522e
feat: grant arcadia xp on dungeon completion
Blushister Apr 10, 2026
73288b6
refactor: rename package and reorganize command architecture
Blushister Apr 11, 2026
84e2990
feat: extend dungeon config for arcadia progression tuning
Blushister Apr 11, 2026
7075265
docs: add epic 8 in-game test procedure report
Blushister Apr 11, 2026
a54caf2
merge: codex/runtime-combat-tuning into master
Blushister Apr 11, 2026
e3ea6fd
chore: update mod author metadata
Blushister Apr 11, 2026
ac3b5b9
refactor: stabilize admin gui and progression flows
Blushister Apr 12, 2026
3b787ce
feat: refactor event handlers, fix Apotheosis charm suppression (Curi…
Blushister Apr 17, 2026
637d6ae
es
Aleeee12 Apr 30, 2026
3cfd2aa
es
Aleeee12 Apr 30, 2026
91414ec
es
Aleeee12 Apr 30, 2026
d6aec1c
es
Aleeee12 Apr 30, 2026
4a350e2
es
Aleeee12 Apr 30, 2026
0ce19af
es
Aleeee12 Apr 30, 2026
8611b37
es
Aleeee12 Apr 30, 2026
b2ec834
es
Aleeee12 Apr 30, 2026
93eac98
es
Aleeee12 Apr 30, 2026
243887e
es
Aleeee12 Apr 30, 2026
4748d0e
Update DungeonWorldEventHandler.java
Aleeee12 Apr 30, 2026
634450a
es
Aleeee12 Apr 30, 2026
1591214
Update exclusion message to Spanish
Aleeee12 Apr 30, 2026
1188921
Update DungeonInstance.java
Aleeee12 Apr 30, 2026
41758d3
es
Aleeee12 Apr 30, 2026
8453be0
Update PlayerProgress.java
Aleeee12 Apr 30, 2026
242bef4
Update PlayerProgressManager.java
Aleeee12 Apr 30, 2026
e3916eb
Update PlayerProgress.java
Aleeee12 Apr 30, 2026
d7372db
Update WaveInstance.java
Aleeee12 Apr 30, 2026
d595f8a
Update WeeklyLeaderboard.java
Aleeee12 Apr 30, 2026
1a36612
Update ArcadiaProgressionConfig.java
Aleeee12 Apr 30, 2026
df30536
Update ConfigManager.java
Aleeee12 Apr 30, 2026
248a97e
Update DungeonConfig.java
Aleeee12 Apr 30, 2026
34af528
Update DungeonConfig.java
Aleeee12 Apr 30, 2026
2b3c197
Update AccessoriesCompat.java
Aleeee12 Apr 30, 2026
44ac794
Update ApotheosisCompat.java
Aleeee12 Apr 30, 2026
a813c0e
Update CuriosCompat.java
Aleeee12 Apr 30, 2026
dba9a36
Update ArcadiaAdminConfigCommandActions.java
Aleeee12 Apr 30, 2026
0e66e91
Update ArcadiaAdminDungeonCommandActions.java
Aleeee12 Apr 30, 2026
00cb954
Update ArcadiaAdminDungeonCommandActions.java
Aleeee12 Apr 30, 2026
d489274
Update ArcadiaAdminSupportCommandActions.java
Aleeee12 Apr 30, 2026
4c40f07
Update ArcadiaCommandHelper.java
Aleeee12 Apr 30, 2026
960d8db
Update ArcadiaProgressionCommandActions.java
Aleeee12 Apr 30, 2026
d406de5
Update ArcadiaRuntimeCommandActions.java
Aleeee12 Apr 30, 2026
d8c9593
Update BossInstance.java
Aleeee12 Apr 30, 2026
1690392
Update BossManager.java
Aleeee12 Apr 30, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -14,3 +14,9 @@ out/
logs/
.claude/
gradle-wrapper.jar
.vscode

# Local BMAD/Codex workspace artifacts
.agents/
_bmad/
_bmad-output/
688 changes: 0 additions & 688 deletions PROCEDURE_TEST.html

This file was deleted.

256 changes: 256 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,256 @@
# Arcadia Dungeon

Un système de donjons **entièrement configurable** pour serveurs Minecraft avec des bosses adaptatives, des phases de combat, des récompenses et bien plus !

**Mod ID:** `arcadia_dungeon`
**Version:** 1.0.0
**Auteur:** Blushister, vyrriox
**Plateforme:** NeoForge 1.21.1

---

## 🎮 Fonctionnalités

### 🏰 Système de Donjons Avancé

- **Configuration JSON complète** : Définissez des donjons avec tous les détails souhaités
- **Systèmes de phases** : Bosses avec plusieurs phases de combat
- **Bosses adaptatives** : Augmentation de santé/dégâts en fonction du nombre de joueurs
- **Invocation de sbires** : Les bosses peuvent invoquer des créatures alliées
- **Points de contrôle** : Téléportation au spawn/retour à la fin

### ⚔️ Combat Avancé

- Multiplicateurs de dégâts et vitesse personnalisables par phase
- Actions requises (tuer les sbires, attendre, etc.)
- Invulnérabilité pendant les transitions de phase
- Immunité aux dégâts configurable
- Messages de phase personnalisés

### 🎯 Gestion des Récompenses

- Récompenses personnalisables pour chaque dungeon
- Cooldowns après complétion
- Support des commandes post-complétion

### 📢 Notifications

- Annonces globales de démarrage/complétion
- Annonces d'échec
- Messages colorés configurables

### 🔐 Permissions

- Système de permissions compatibles **LuckPerms**
- `arcadia_dungeon.bypass.antiparasite` : Contourner le système anti-parasite
- `arcadia_dungeon.bypass.antifly` : Contourner le système anti-vol

### 📊 Intégrations Optionnelles

- **LuckPerms** : Gestion avancée des permissions
- **Spark** : Profilage de performance

---

## 📋 Pré-requis

- **Java 21** ou supérieur
- **Minecraft 1.21.1**
- **NeoForge 21.1.0+**

---

## 🚀 Installation

### Pour les serveurs

1. Téléchargez le fichier JAR du mod depuis les [releases](https://github.com/vyrriox/Arcadia/releases)
2. Placez-le dans le dossier `mods` de votre serveur NeoForge
3. Redémarrez le serveur

### Pour le développement

```bash
# Clone le repository
git clone https://github.com/vyrriox/Arcadia.git
cd Arcadia-Dungeon

# Construire le projet
./gradlew build

# Lancer le serveur en développement
./gradlew runServer

# Lancer le client en développement
./gradlew runClient
```

---

## ⚙️ Configuration

Les donjons se configurent via des fichiers **JSON** dans le répertoire `dungeon-configs/`.

### Structure d'un Dungeon

```json
{
"id": "mon_donjon",
"name": "Mon Donjon",
"cooldownSeconds": 3600,
"announceStart": true,
"announceCompletion": true,
"startMessage": "&6[Donjon] &e%player% lance &e%dungeon%!",
"completionMessage": "&6[Donjon] &a%player% a vaincu &e%dungeon%!",
"failMessage": "&6[Donjon] &c%player% a échoué dans &e%dungeon%!",
"teleportBackOnComplete": true,
"spawnPoint": {
"dimension": "minecraft:overworld",
"x": 0.0,
"y": 64.0,
"z": 0.0,
"yaw": 0.0,
"pitch": 0.0
},
"bosses": [
{
"id": "boss_1",
"entityType": "minecraft:wither",
"customName": "Chef du Donjon",
"baseHealth": 300.0,
"baseDamage": 20.0,
"healthMultiplierPerPlayer": 0.5,
"damageMultiplierPerPlayer": 0.2,
"phases": [
{
"phase": 1,
"healthThreshold": 1.0,
"damageMultiplier": 1.0,
"speedMultiplier": 1.0,
"description": "Phase 1",
"phaseStartMessage": "&e[Boss] Préparez-vous!",
"summonMobs": [],
"requiredAction": "NONE"
}
]
}
]
}
```

### Variables Disponibles

- `%player%` : Nom du joueur
- `%dungeon%` : Nom du dungeon

### Schéma JSON

Consultez [dungeon-schema.json](dungeon-configs/dungeon-schema.json) pour la liste complète des propriétés disponibles.

### Exemple

Un exemple complet est fourni dans [dungeon-configs/examples/example_dungeon.json](dungeon-configs/examples/example_dungeon.json).

---

## 🎮 Utilisation

### Commandes

```
/arcadia_dungeon list # Lister tous les donjons
/arcadia_dungeon info <dungeon_id> # Afficher les infos d'un dungeon
/arcadia_dungeon join <dungeon_id> # Rejoindre un dungeon
/arcadia_dungeon leave # Quitter le dungeon actuel
/arcadia_dungeon reload # Recharger les configurations
```

---

## 🔧 Développement

### Structure du Projet

```
src/main/java/com/vyrriox/arcadiadungeon/
├── ArcadiaDungeon.java # Point d'entrée du mod
├── boss/ # Système de boss
├── command/ # Commandes
├── config/ # Configuration & sérialisation
├── dungeon/ # Gestion des donjons
├── event/ # Gestionnaires d'événements
└── util/ # Utilitaires
```

### Build

```bash
# Compiler uniquement
./gradlew compileJava

# Compiler et tester
./gradlew build

# Générer les sources en IDE
./gradlew genSources
```

### Gradle Properties

Les propriétés principales se trouvent dans [gradle.properties](gradle.properties):

- `minecraft_version`: Version Minecraft ciblée
- `mod_version`: Version du mod
- `mod_id`: Identifiant unique du mod
- `mod_authors`: Auteurs du mod

---

## 📖 Documentation Additionnelle

- [Procédure de Test](PROCEDURE_TEST.html) - Guide pour tester le mod
- [Schéma JSON](dungeon-configs/dungeon-schema.json) - Schéma complet de configuration

---

## 🐛 Dépannage

### Le mod ne charge pas

- Vérifiez que vous utilisez Java 21+
- Assurez-vous que NeoForge 21.1.0+ est installé
- Consultez les logs du serveur pour les erreurs

### Les donjons ne se chargent pas

- Vérifiez que les fichiers JSON sont dans `dungeon-configs/`
- Validez la syntaxe JSON
- Vérifiez les logs pour les erreurs de parsing

---

## 📄 Licence

**All Rights Reserved** - Tous droits réservés

---

## 🤝 Contribution

Les contributions sont bienvenues ! Pour soumettre des améliorations :

1. Créez une fork du projet
2. Créez une branche (`git checkout -b feature/ma-feature`)
3. Committez vos changements (`git commit -am 'Ajout de ma feature'`)
4. Pushez vers la branche (`git push origin feature/ma-feature`)
5. Créez une Pull Request

---

## 📞 Support

Pour les rapports de bugs ou les demandes de features, consultez la page [Issues](https://github.com/vyrriox/Arcadia/issues) du projet.

---

**Fait par Blushister, vyrriox - Enjoy your dungeons!**
1 change: 1 addition & 0 deletions build.gradle
Original file line number Diff line number Diff line change
Expand Up @@ -56,6 +56,7 @@ configurations {

dependencies {
implementation "net.neoforged:neoforge:${neo_version}"
implementation "com.arcadia.core:arcadia_core:0.1.0"
}

tasks.withType(ProcessResources).configureEach {
Expand Down
6 changes: 6 additions & 0 deletions docs/reports/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
# Arcadia Dungeon Reports

Ce dossier regroupe les rapports HTML et procédures de test générés pendant le développement.

- `procedure-test.html` : procédure de test serveur.
- `rapport-arcadia-dungeon.html` : rapport de validation Arcadia Dungeon.
Loading