portfolio/PLUGINS.md

Plugins Hytale — Phase 10 (v1.2)

5 plugins wow + dev rapide (1-2j) ciblés pour gif Twitter/Discord + DMs. Après analyse de marché (avril 2026), j'ai rééquilibré les 4 remplacements vers des catégories moins saturées quand possible (magie = 1 seul plugin payant, système de classes rare, combat-counter spécifique).

Chaque plugin reste simple à coder, visuellement fort, et produit un gif 5-10s clip-ready. Les frameworks sérieux (myth_lib OSS, Quest Framework, MythGuard, MythArena) sont déplacés en Phase 12+ (roadmap longue, 2-6 semaines chacun).

---

1. GravityFlip Region (~1j)

Repo : hytale-gravity-flip

Block custom qui définit une zone. Toute entité qui entre a sa gravité inversée (marche plafond, items tombent vers le haut).

• Hook PlayerMoveEvent, check région, flip velocity.y
• Commande : /gravityflip define <name> pour capturer 4 corners ou alors un item (giveable ou craftable comme le //wand pour set pos1 et 2)

---

2. ChainLightning Sceptre (~1j)

Repo : hytale-chain-lightning Catégorie marché : Magie (1 seul plugin payant sur BBB — quasi-vide). Différentiation vs Wan's Wonder Weapons (342K free) : ce n'est pas un projectile classique, c'est une mécanique de chaînage visuellement unique.

Bâton magique : cible un mob → la foudre saute de cible en cible (max 5 targets dans un rayon de 8 blocs entre chaque saut), avec dégâts dégressifs et traînées électriques visibles.

• Item custom chain_lightning_sceptre cooldown 4s
• Ray-cast 25 blocs → find first entity
• BFS entity graph : chaque cible ajoute la suivante la plus proche (radius 8), skip déjà-hit, max 5 chaînes
• Damage dégressif : 8, 6, 4, 3, 2 HP
• Particles ELECTRIC_SPARK + END_ROD en ligne entre chaque paire de cibles
• Son lightning_bolt atténué à chaque saut

---

3. ShadowClone Decoy (~1j)

Repo : hytale-shadow-clone Catégorie marché : Combat unique / anti-death (gameplay-saving, catégorie peu exploitée)

Juste avant la mort (HP < 2), spawn automatique d'un clone immobile qui tank le prochain hit pendant que le joueur devient invisible 2s et téléporte 5 blocs en arrière. Cooldown 60s.

• EntityDamageEvent priority HIGHEST → si health - damage ≤ 2 et pas en cooldown
• Spawn NPC clone (skin du joueur) à la position actuelle
• player.setInvisible(true) + teleport derrière + particles SMOKE
• Next damage sur le clone → clone.remove() + particles POOF
• Cooldown stocké en PDC (PersistentDataContainer)

---

4. GrapplingHook (~1.5j)

Repo : hytale-grappling-hook Catégorie marché : Mouvement (classique mais toujours demandé, pattern Spider-Man recognizable)

Hook custom lancé, s'accroche au premier block/entité touché, tire le joueur vers le point d'ancrage avec animation de rope en particules.

• Item grappling_hook right-click → launchProjectile(CustomProjectile) linear
• ProjectileHitEvent → calcule vecteur (hit_loc - player.loc), player.setVelocity(vec.normalize().multiply(1.8))
• Particle line entre joueur et point d'impact pendant le pull (tick task DUST noir)
• Block hit = pull fort, entité hit = pull vers l'entité (combat grab)
• Cooldown 5s, range max 20 blocs

---

5. EarthquakeSlam (~1j)

Repo : hytale-earthquake-slam Catégorie marché : Combat AoE visuel (gif-ready max, onde de choc)

Saut en hauteur (>5 blocs chute) → impact au sol = onde de choc circulaire qui repousse et stun 2s les mobs dans un rayon de 6 blocs. Particles ripple ground dramatique.

• PlayerMoveEvent détecte fall state (fallDistance >= 5 + isOnGround)
• Scan entities in radius 6 via world.getNearbyEntities(loc, 6, 2, 6)
• Knockback vector = (entity.loc - player.loc).normalize().multiply(1.5)
• entity.addPotionEffect(SLOWNESS 80 ticks amplifier 5) pour stun
• Particles ripple : BLOCK_CRACK (dirt/stone) en cercle expanding 3 ticks

---

Notes

• Stack commune : Java ou Kotlin (first-class supporté), JDK 17+, Gradle Kotlin DSL
• Package : fr.killiandalcin.hytale.<plugin>
• License : MIT (permissif, encourage usage et SEO)
• README chaque repo : hero gif 5-10s, tagline EN, features, install, commands, lien portfolio
• Distribution : GitHub public (kayjaydee/hytale-*) + release jar attachée à chaque tag v0.x.0. Pas Fiverr (destruction positionnement selon analyse de marché)
• Cible contenu : 1 gif par plugin à poster sur Twitter/Discord HytaleModding, + portfolio killiandalcin.fr/hytale section "Live Demos"
• Ordre de ship suggéré : GravityFlip (#1) d'abord (le plus rapide + impact visuel max), puis ChainLightning Sceptre (#2) + EarthquakeSlam (#5) pour compléter le trio visuellement fort, puis ShadowClone (#3) et GrapplingHook (#4) comme mécaniques plus avancées
• Audit concurrence : Aucun des 5 plugins ne duplique les dominants gratuits cités dans l'analyse (BetterMap 502K, EyeSpy 407K, Wan's Wonder Weapons 342K, RPG Leveling 277K, MMO Skill Tree 251K, Spellbook 181K). FireballStaff remplacé par ChainLightning Sceptre pour éviter le conflit direct avec Wan's (custom weapons génériques)

Effort total estimé : ~6.5 jours (vs. 10j des 5 précédents). Rééquilibrage vers catégories sous-servies quand possible sans sacrifier le "wow rapide".