Jump to content

[1.11.2] [SOLVED] Use the new @Config-compatible config GUI


Recommended Posts

Posted (edited)

Hi,

 

I just saw the commit "Use the new @Config-compatible config GUI" on Choonster's TestMod3 and some threads about it here on the forum.

Can someone explain to me how this system works?

 

Thx in advance.

Bektor

Edited by Bektor

Developer of Primeval Forest.

Posted

Are you asking about the annotation-based config system or the recent addition of the config GUI compatible with it?

 

If it's the former, create a class to hold your config options and annotate it with @Config. This class should have a static field for each option or sub-category. These fields can be one of the following types:

  • Any primitive or primitive wrapper class or array of primitives/wrappers. This will be mapped to single value or list property of the corresponding type in the config file.
  • String or String[]. This will be mapped to string or string list property.
  • An enum. This will be mapped to a string property, but will throw an error if set to an invalid value.
  • Map<String, T>, or any class that implements it. T may be any of the previous types. This will be mapped to a category containing a property for each key/value pair in the Map.
  • Any class that directly extends Object. These will be mapped to a category containing a property for each of the class's non-static fields. The fields can be any of these types, including another class that directly extends Object.

You can use the sub-annotations of @Config to set the lang key (for the config GUI), comment (used in the config file, also in the config GUI if there's no translation for langKey + ".tooltip"), value range (for numeric properties), property/category name and whether changing the property's value requires restarting Minecraft or the world.

 

To use the config GUI with this system, all you need to do is subscribe to ConfigChangedEvent.OnConfigChangedEvent. If the event's mod ID is your mod ID, call ConfigManager.sync with your mod ID and Config.Type.INSTANCE.

 

You can see a basic implementation of this here. The translations for this can be found here.

  • Like 1

Please don't PM me to ask for help. Asking your question in a public thread preserves it for people who are having the same problem in the future.

Posted (edited)
33 minutes ago, Choonster said:

 

Are you asking about the annotation-based config system or the recent addition of the config GUI compatible with it?

 

Basically about both. The last time I worked with both of them, I did everything completly without annotations.

 

And thx for the answer.

Edited by Bektor

Developer of Primeval Forest.

  • 7 months later...

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.
Note: Your post will require moderator approval before it will be visible.

Guest
Unfortunately, your content contains terms that we do not allow. Please edit your content to remove the highlighted words below.
Reply to this topic...

×   Pasted as rich text.   Restore formatting

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

Announcements



×
×
  • Create New...

Important Information

By using this site, you agree to our Terms of Use.