Configuration Files

Supported MCreator versions
2022.3
2023.1
2023.2
2023.3
2023.4
2024.1
2024.2
2024.3
Tags / plugin type
Java plugin
Procedures
Templates
configs
Downloads:
5528
Upvotes: 78
About the plugin

Configuration FIles is a plugin that allows for the creation of mod configuration files, through which parts of your mod can be enabled, disabled or modified using variable values stored inside it. Those values can then be changed by the mod's users, allowing for more control over your mod's features.

 

How to use?

 

Configurations are very simple to use. You will first need to create a configuration element.

config

Once created, you can make a configuration category and add variable types to it. Note that registry name types are considered texts.


You can then use the variables in procedures by following the example below.

example

 

And that's it! The Configuration Files will generate once the game is loaded.

 

The plugin supports versions 1.16.5-1.19.2, but doesn't support 2022.2. Therefore you will need to install the forge generator 1.16.5 plugin for 2022.3 if you plan on using this with 1.16.5

 

This is a Java Plugin and therefore requires the Java Plugins feature to be enabled.

 

 

Changelog

v2.3.1
-Fixed the plugin breaking all blockly panels in some cases (thanks javascript)

v2.3
-Reworked the UI to use a blockly panel (old elements are automatically converted)
-Ported to MCreator 2024.3 and neoforge 1.21.1

v2.2
-Support for MCreator 2024.2 and neoforge 1.20.6

v2.1.1
-Fixed text lists causing the config to regenerate every time the game is launched

v2.1
-Added text list variables to configs
-Added new procedure block: for each entry in config text list
-Added new procedure block: text list iterator

v2.0.1
-Updated to work with MCreator 2024.1.15821

v2.0
-Major UI code refactor
-Configs now have proper validation
-Removed duplicate registry name procedure blocks (If you're using them, get rid of them before updating)
-Cleaned up config template code
-Support for 2024.1
-Support for neoforge 1.20.4

v1.9
-Added 2023.4 support

v1.8
-Ported to 1.20.1
-Disabled standalone comments as they sometimes caused the game to not launch and I have no bloody clue why

v1.7
-Support for 1.19.4 and 2023.2 EAP

v1.6.1
-Removed the version MCreator limit so I dont need to constantly update the plugin

v1.6
-Support for 2023.1 release

v1.5
-Dropped support for 2023.1 snapshot 2
-Support for 2023.1 snapshot 3

v1.4
-Deleted the 1.16.5 templates as that version is now unsupported in 2023.1
-Changed the variable getter procedures to use a datalist for selecting the configuration element
(You will need to select the element again in existing procedures)

v1.3

-Dropped support for 2022.4 snapshot 1 and below due to incompatibilities in the code
-Updated to the 2023.1 snapshot 2

v1.2
-Number variables can now have negative values
-Added the convert registry name to item procedure
-Added the convert registry name to block procedure

v1.1
-Fixed number variables causing build errors
-Fixed number variable procedure causing build errors
-Fixed configurations being part of the items list
-Fixed block and item registry name variables sometimes causing build errors
-Fixed configuration categories generating inside of each other
-Deleted some useless code in the configuration template

Archived versions:
-1.2 for 2022.4 and below https://www.mediafire.com/file/ot4dafj51ilrpws/configuration_files_2022.4-1.2.zip/file
License
MIT License

Plugin downloads
Configuration Files v1.6.1 (MCreator 2023.1 ONLY) - configuration_files_0.zip Uploaded on: 03/08/2023 - 12:15   File size: 38.79 KB
Configuration Files v1.7 (MCreator 2023.1, 2023.2 ONLY) - configuration_files.zip Uploaded on: 04/28/2023 - 22:53   File size: 43.32 KB
Configuration Files v1.8 (MCreator 2023.1, 2023.2, 2023.3 ONLY) - configuration_files.zip Uploaded on: 12/01/2023 - 11:44   File size: 47.9 KB
Configuration Files v2.0 (MCreator 2023.4 ONLY) - configuration_files.zip Uploaded on: 04/12/2024 - 17:27   File size: 40.01 KB
Configuration Files v2.1.1 (MCreator 2024.1 ONLY) - configuration_files_0.zip Uploaded on: 06/17/2024 - 20:30   File size: 47.08 KB
Configuration Files v2.2 (MCreator 2024.2 ONLY) - configuration_files.zip Uploaded on: 07/18/2024 - 18:54   File size: 51.03 KB
Configuration Files v2.3.1 (MCreator 2024.3 ONLY) - configuration_files_0.zip Uploaded on: 11/19/2024 - 09:45   File size: 38.66 KB

Comments

I have an issue related to this plugin and I already posted a forum topic about it, but since this is a relevant space and you (NerdyPuzzle) might hopefully be able to help me with it, I'll also paste it here. I hope that's allowed, sorry if not:
I am already a bit deep into making a mod with various features, using various plugins, and I was trying to add a system to detect mobs that should be categorized as arthropods but aren't. To do this, I used the Configuration Files plugin by NerdyPuzzle and added to my config file variables arthropod_list and arthropod_filter, which are then referred to when a specific projectile hits an entity and is supposed to deal AoE damage to nearby mobs that fit the criteria. After adding those two variables, trying to run the game or regenerate code gives me a compilation error message.

it was too long for a comment, so here are the other two paragraphs:
Does anyone have any ideas for how this could be fixed, or do I simply have to not include my arthropod detection system because it will inevitably make the mod non-functional?
Also I wanted to include the workspace file here so that anyone can see what exactly it is I'm dealing with, but I don't see an option to embed files. How can I share the file here? Do I need to upload it elsewhere and link it?

hey i wanted to point out that 2.3.1 actually works also with 2024.2 , i tested it and everything worked well so far

Sorry to be a pain Nerdy but I'm getting some compiling errors, I can open the procedures fine and save them but they're getting a 'cannot find symbol' error. Do you have any suggestions?
Also thanks for fixing the procedure issue!

Config element been completely wiped after updating

It appears the latest update breaks something with procedures. With the plugin installed I can't open any procedures but soon as I remove it I can open them fine

I'm fairly certain. I've made a completely new workspace with no plugins install prior to creation. Installed Config plugin and loaded the workspace again, create a new procedure and nothing shows up. I've tried reinstalling mcreator also. Yes using the lates patch uploaded:

Configuration Files v2.3 (MCreator 2024.3 ONLY) - configuration_files.zipUploaded on: 11/17/2024 - 14:15

hi nerdy! how are you. was just woundering if you can update your plugin builder for mcreator so automatically adds 2024.3 in the supported versions to created plugins? it only does 2024.1 and 2024.2 (online information file keeps reseting when i try to chang eut)

So I've done the following and still doing the same thing. Blockly editor is just completely blank, no options on the left or anything.
- Uninstall Mcreator entirely
- Restart PC
- Install latest Mcreator version
- Still Configuration plugin ONLY
- Load fresh new workspace

for those who need this for 2024.3 just go into the zip file, open plugin.json, and look for 2024002 nd replace that with 2024003. this will likely cause some support issues and if any bugs happen dont report them as a bug on the plugin page as the plugin is not designed to run on 24.3 this is only a temporary solution for those who absolutely need it for 24.3 now.

Heya Nerdy, a way to change config values with procedures could be possible?