🪧Système de Logements

Ce document présente comment configurer et utiliser le système de logements (houses) dans le plugin Horizons.

📂 Structure des Fichiers

Les logements sont gérés via plusieurs fichiers de configuration situés dans le dossier plugins/Horizons/:

  • houses.yml - Stocke les informations sur les maisons

  • config.yml - Contient les paramètres généraux du système, notamment les formats des panneaux

🏗️ Types de Logements

Types Disponibles

Le plugin supporte deux types de logements :

Type
Description
Monnaie Utilisée

PLAYER

Maisons appartenant à des joueurs individuels

Points personnels

TEAM

Maisons appartenant à des équipes entières

Points d'équipe

🛠️ Commandes

Le système de logements est géré par la commande principale /house ou son alias /housing.

Commandes Disponibles

Commande
Description
Permission

/house create <nom> <team|player>

Crée une nouvelle maison

horizons.house.create

/house forsale <nom> <prix>

Met une maison en vente

horizons.house.forsale

/house addmember <nom> <joueur>

Ajoute un membre à une maison

Propriétaire

/house removemember <nom> <joueur>

Retire un membre d'une maison

Propriétaire

/house list [page]

Liste toutes les maisons

horizons.house.list

/house delete <nom>

Supprime une maison

horizons.house.delete

/house setsign <nom>

Définit un panneau pour une maison

horizons.house.setsign

/house restrictteam <nom> [équipe|none]

Restreint l'achat d'une maison à une équipe

horizons.house.restrictteam

/house setmaxmembers <nom> <nombre>

Définit le nombre maximum de membres

horizons.house.setmaxmembers

🔑 Créer une Maison

Pour créer une maison, vous devez d'abord sélectionner une zone avec WorldEdit, puis utiliser la commande /house create.

Étapes pour créer une maison :

  1. Obtenez l'outil de sélection WorldEdit avec //wand

  2. Sélectionnez deux points opposés pour définir la zone

  3. Exécutez /house create <nom> <team|player>

💰 Vente et Achat de Maisons

Mettre une maison en vente

Utilisez la commande /house forsale <nom> <prix> pour mettre une maison en vente à un prix spécifique.

Acheter une maison

Les joueurs peuvent acheter une maison en cliquant sur un panneau de vente. Notez que:

  • Pour les maisons de type PLAYER, le coût est prélevé uniquement des points personnels du joueur

  • Pour les maisons de type TEAM, le coût est prélevé des points de l'équipe du joueur

Restrictions d'achat par équipe

Vous pouvez restreindre l'achat d'une maison à une équipe spécifique :

  • Pour restreindre : /house restrictteam <nom> <équipe>

  • Pour supprimer la restriction : /house restrictteam <nom> none

  • Pour vérifier la restriction actuelle : /house restrictteam <nom>

🚪 Gestion des Membres

Maisons de joueurs

Les propriétaires peuvent ajouter/retirer des membres :

  • /house addmember <nom> <joueur> - Ajoute un membre à la maison

  • /house removemember <nom> <joueur> - Retire un membre de la maison

Limite de membres

Chaque maison de type PLAYER possède une limite configurable de membres:

  • La limite par défaut est de 3 membres

  • Utilisez /house setmaxmembers <nom> <nombre> pour modifier cette limite

  • Le propriétaire n'est pas compté dans cette limite car il a accès automatiquement

Maisons d'équipe

Pour les maisons d'équipe, tous les membres de l'équipe ont automatiquement accès à la maison.

🪧 Panneaux de Maisons

Les maisons demandent d'avoir des panneaux informatifs qui permettent de les acheter.

Configuration des Panneaux

Utilisez la commande /house setsign <nom> en visant un panneau pour l'associer à une maison.

Format des Panneaux

Les formats d'affichage des panneaux sont configurables dans config.yml :

Maisons à vendre

houses:
  signs:
    for-sale:
      line1: "&9『 {type} 』"
      line2: "&f⌂ &e{name}"
      line3: "&a&l✦ À VENDRE ✦"
      line4: "&e{price}"

Maisons occupées

houses:
  signs:
    occupied:
      line1: "&9『 {type} 』"
      line2: "&f⌂ &e{name}"
      line3: "&c&l❖ OCCUPÉE ❖"
      line4: "&7Propriétaire: &f{owner}"

Placeholders disponibles

Placeholder
Description

{type}

Type de maison (Équipe/Joueur)

{name}

Nom de la maison

{price}

Prix avec la devise

{owner}

Nom du propriétaire

{team}

Nom de l'équipe (pour les maisons d'équipe)

{team_restriction}

Équipe ayant le droit d'acheter la maison

{max_members}

Nombre maximum de membres autorisés

{current_members}

Nombre actuel de membres

{members_count}

Affichage "actuel/maximum" des membres

🔄 Cycle de Vie d'une Maison

  1. Création : Un administrateur crée la maison avec WorldEdit et /house create

  2. Mise en vente : La maison est mise en vente avec /house forsale

  3. Achat : Un joueur achète la maison, devenant propriétaire

  4. Utilisation : Le propriétaire peut ajouter des membres (jusqu'à la limite configurée)

🏠 Configuration des Maisons

Chaque maison dans houses.yml possède plusieurs propriétés configurables :

houses:
  MaMaison:
    world: world
    owner: df7d5ec6-eb81-4588-92e4-63b607481348
    forSale: false
    price: 1500
    type: PLAYER
    max-members: 3  # Limite de membres configurable
    signs:
      '0':
        world: world
        position: -22.0,-42.0,-62.0

♻️ Rechargement du Système

Le système de maisons peut être rechargé via la commande /horizons reload housing. Cette commande:

  • Recharge la configuration

  • Met à jour toutes les maisons

  • Actualise les panneaux

📋 Exemple Complet

Création et configuration d'une maison

# Sélectionner une zone avec WorldEdit
//wand
(sélectionner deux points)

# Créer une maison d'équipe
/house create VillaDeluxe team

# Mettre la maison en vente
/house forsale VillaDeluxe 10000

# Configurer un panneau
/house setsign VillaDeluxe 
(viser un panneau)

# Restreindre l'achat à une équipe
/house restrictteam VillaDeluxe Aventuriers

Gestion des membres d'une maison personnelle

# Définir la limite de membres pour une maison
/house setmaxmembers MaMaison 5

# Ajouter des membres à la maison
/house addmember MaMaison Joueur1
/house addmember MaMaison Joueur2

# Retirer un membre de la maison
/house removemember MaMaison Joueur1

🛡️ Permissions

Permission
Description

horizons.house.create

Permet de créer des maisons

horizons.house.forsale

Permet de mettre des maisons en vente

horizons.house.admin

Accès complet à toutes les fonctionnalités

horizons.house.delete

Permet de supprimer des maisons

horizons.house.setsign

Permet de configurer des panneaux

horizons.house.restrictteam

Permet de restreindre l'achat à une équipe

horizons.house.setmaxmembers

Permet de modifier la limite de membres

horizons.house.help

Permet d'afficher toutes les commandes d'aide

🧠 Concepts Avancés

Interaction avec WorldGuard

Le système de logements utilise WorldGuard pour gérer les régions protégées. Chaque maison est associée à une région WorldGuard portant le préfixe "house_" suivi du nom de la maison.

Intégration avec le Système d'Équipes

  • Les maisons d'équipe utilisent le système d'équipes du plugin

  • Le coût des maisons d'équipe est prélevé des points d'équipe

  • Tous les membres de l'équipe ont accès aux maisons d'équipe

Logique de Paiement

  • Maisons personnelles (PLAYER) : Le coût est prélevé uniquement des points personnels du joueur

  • Maisons d'équipe (TEAM) : Le coût est prélevé des points de l'équipe du joueur

Gestion des Membres

  • Le propriétaire a toujours accès à sa maison et n'est pas compté dans la limite de membres

  • Il est impossible d'ajouter le propriétaire comme membre car il a déjà accès

  • Chaque maison a une limite configurable de membres (la valeur par défaut est 3)

Mise à jour des Panneaux

Les panneaux de maisons sont automatiquement mis à jour :

  • Lors du chargement du plugin

  • Lors de la mise en vente d'une maison

  • Lors de l'achat d'une maison

  • Lors de la modification des restrictions d'équipe

Protection des Panneaux

Les panneaux associés aux maisons sont protégés contre la destruction par les joueurs non-administrateurs.

PrécédentMarché NoirSuivantSystème de Resource Pack