Addons et customisation

DynamX est facilement customisable grâce à son système d'addons, permettant d'ajouter de nouvelles propriétés aux véhicules, au props... Des exemples sont fournis, comme des clés, des sirènes ou même un système de courses.

Important

Prérequis : vous devez ajouter DynamX à votre projet : instructions ici.

Info

Plus de détails sont donnés dans la javadoc de DynamX, faite en Anglais et avec amour.

Créer un addon

Un addon DynamX peut être inclus dans un mod (avec une annotation @Mod), ou bien ce peut être uniquement un addon sans mod associé.

Info

Si votre addon est aussi un mod, pensez à ajouter dependencies = "before: dynamxmod" dans votre annotation @Mod.

Pour que votre addon soit détecté, sa classe principale doit posséder l'annotation @DynamXAddon (qui peut être cumulée avec l'annotation @Mod). Vous devez ensuite implémenter une fonction publique et statique, retournant le type void, annotée avec @DynamXAddon.AddonEventSubscriber. Son nom peut être quelconque.

Exemple

@Mod(modid = HelloWorldAddon.ID, name = "DynamX HelloWorld Addon", version = "1.0.0", dependencies = "before: dynamxmod")
@DynamXAddon(modid = HelloWorldAddon.ID, name = "HelloWorld Addon")
public class HelloWorldAddon
{
    public static final String ID = "dynamx_hello_world";

    @DynamXAddon.AddonEventSubscriber
    public static void init()
    {
        System.out.println("Hello world !");
    }
}

Voilà, vous avez un addon fonctionnel ! Mais il ne fait rien...

Ajouter des fonctions à son addon

Info

Vous devez toujours enregistrer les propriétés et objets dans la fonction init de votre addon.

Différents tutoriels sont disponibles sur différents aspects de DynamX :