Jump to content

Brady_The

Very supportive Vintarian
  • Posts

    672
  • Joined

  • Last visited

  • Days Won

    7

Everything posted by Brady_The

  1. ZIP file naming scheme suggestion These suggestions are my own and do not have to be followed. However, I believe that following those rules greatly improve user and trouble-shooter friendliness. Consider naming your zip file in the following manner: "usernamemymodid-vmodversion_vgameversion" (e.g. bradysupremestickmod-v1.0.1_v1.21.6) Explanation: username Either your username or a short version of it. Mods are currently sorted alphabetically in the in-game mod list, so using your user name in front will guarantee that all of your mods are listed together, making it much easier for users to browse the mod list. If you are planning to release serialised mods, you can choose a unique identifier instead. Tentharchitect's mods are a good example. mymodid The ID you chose for your mod in modinfo.json. - modversion The current version of your mod. See https://semver.org/ for more details. A fairly common first version would be 1.0.0. _ gameversion The version of the game you tested your mod with. Ideally it would be the most up-to-date stable version of the game. In the above example is that version 1.21.6. This naming convention has two huge advantages. 1. The user knows exactly what version is installed. 2. Any trouble-shooters trying to detect the source of a problem can immediately dismiss your mod as a potential source, or focus on it. This is a particular good reason to follow this convention. Not much is more frustrating than going through a massive log and having to spend a massive amount of time with researching mod details. Changelog template Once again this is my own personal solution which you do not have to follow. I personally prefer to use the Source Code Editor, which you can access with the < > button in the Add new Mod/Edit and Add new Release/Edit Release view. This gives me a better control about the layout of the changelog. Copy the code below, open the Source Code Editor and paste the content. Edit the changelog so that it fits your mod release. Remove unused categories, expand the lists, etc. If you do not wish to handle any HTML at all you can simply use the example below for pointers. Edit releases If you want to edit the changelog or add a compatible game version to an already released mod you don't have to upload a new version. Navigate to your mod on the ModDB, switch to the Files tab and click on the release version number you want to edit. This will bring you to the Edit Release window. Adjust the details you want to change and press Save. Retract releases Releasing a critically broken mod through an oversight happens faster than you would like to think. Critical in this context means that the version of the mod you released to the public can cause the game to freeze or crash, or in the worst case, brick a save game. To retract a release you head to Edit Release window. Click on the release version number you want to retract. Next you click on the Retract Release window. Follow the instructions. Note: Be aware that by retracting a release any server that is running this particular version of your mod can potentially seize to function. Discord modder role If you would like to advertise your mod in the #spotlight channel or the mods forum, you can request the modder role from @Moderator with a link to your mod on the ModDB, which will allow you to do so. If your Discord user name differs from your ModDB user name further verification may be required of you. Server tweaks If you developed a mod or created a patch mod that changes settings from public mods for your server, you can Edit the Category your modification will appear on the ModDB. If you are unsure where you can do that, I refer you to step 6 in the previous comment for directions. Change the category to Server-specific Tweak. This category is separated from the other mods, allowing you to modify your server to your heart's content without flooding the front page of the ModDB. Test releases This option is a bit too advanced for the purpose of this HowTo, but the existence of this feature is still worth mentioning. Changelog: 10.12.2025 | ModDB - A new version compatibility selector has been rolled out, aiming to simplify the selection of multiple versions. Holding down Ctrl isn't necessary any more. 17.12.2025 | Thread - Added optional information to this comment. 23.12.2025 | Thread - Added note to changelog template. 24.12.2025 | Thread - Added information about test releases 09.10.2025 | Thread - Added information about new user tagging method to changelog template
  2. Your finished your first mod and now want to share it with the world. Fantastic! The most convenient way to do that, for you - as a mod author - and the end user, would be to use the ModDB service provided by Anego Studios. Uploading your first mod can be a bit tricky, though. That's where this step-by-step guide comes in. Head over to https://mods.vintagestory.at/ and login. The ModDB utilises your game account - no separate login credentials are needed. Click on Submit a mod or follow this link. You will be greeted with the following view (scroll down for more input fields). Fill out all the details you would like to add. Most of them don't matter in this first step. However, the Name and the Summary are required. Choose an informative name for your mod. I generally stick to the "name" value I picked for the modinfo file. Choose an informative summary that describes your mod and makes people want to click on your mod thumbnail. After you filled in all the information and maybe added some screenshots (remember, all of this can be done and changed at a later point), click on the Save button. This will save your mod and keep you in the Edit mode. Notice your mod name in the navigation ( Mods / [Your Mod name] / Edit ). Click on it. This will bring you to the mod view you probably already know from other mod pages you visited in the past, with the small addition of some administrative tools. The Edit button will bring you back to the previous view. This way you can later add or change information you didn't fill out in the previous steps. Click on the Add release button. This will bring you to the following view. First you want to upload your zipped mod file. To do this, follow the instructions in the Files section. After you have done that, add the game versions your mod is compatible with. Pro tip: If your mod is supporting multiple versions, hold down the Ctrl key when clicking on any game version to keep the menu open. Add an informative changelog so that potential users know what has been Added, Changed, or Removed to/from the mod. After you have filled out all the required information, click on the Save button (the information for "Mod Id" and "Mod Version Number" are going to be pulled from the modinfo.json). If you did everything correctly in the creation of the modinfo file, you are good to go. If you missed something, the ModDB should now tell you exactly what is wrong with the file. Correct these mistakes and try again! You are almost done. Now all you have to do is to change the mod status or visibility. To do that, click on your mod name in the navigation and on the Description tab. There you click on Edit. Fill out any information you might want to add or change. Next to an informative summary a thumbnail will guarantee to draw the eye of any potential user. To do that, upload a screenshot and set it in the Logo image found in the Additional Information section. Both options are optional and have different requirements. Once you are satisfied, change the Status from Draft to Published (it's the first drop-down menu) and hit the Save button. That's it. Now you are a published mod author. Congratulations!
  3. Did you try this? https://cdn.imgchest.com/files/2a94cf031637.png
  4. The ucontents item code might need the mod domain to properly function. That's the first thing I'd try. Also, looking at your original variantgroups, it's very easy to simplify them: variantgroups: [ { code: "color", states: [ "acacia", "aged", [...] ] } { code: "intensity", states: [ "1", "2", "3", "4" ] } ], Edit: Looking at the variantgroups a bit closer this might not be as easy, considering that the combinations are a bit random. Still, technically doable with "skipVariants" or https://wiki.vintagestory.at/Modding:Registry_Object_JSON_Parsing#Enumerating_variants (which is somwhat more complicated).
  5. Most interesting would be a "mini-game" akin to the potion-brewing in Kingdom Come Deliverance, but I am not sure if that's something that will ever be implemented, nor if it even fits the kind of game VS is.
  6. Entities are a bit special. You need an "entities" file to create it, an an "itemtypes" file to make them accessible in-game. You could look at how Vanilla does it, but I personally would use a mod, because those files are usually a bit more accessible in terms of size and readability. https://mods.vintagestory.at/thylacinidae would be a good candidate, because it currently adds only one animal. If you want to have a look at the Vanilla files, you can find them in "assets\survival\itemtypes", they are called "creature*.json".
  7. Don't use "survival". Use "game". That domain is encompassing all Vanilla folders.
  8. You are using byType incorrectly. Have a look at this wiki tutorial to see the correct syntax.
  9. Their code changed. It's "raccoon-common-adult-male" now.
  10. Those are called variant substitutions and can carry information from an ingredient into the output in a recipe, if used correctly. Example: { "ingredientPattern": "S,D", "width": 1, "height": 2, "ingredients": { "S": { "type": "item", "code": "game:saw-*", "isTool": true }, "D": { "type": "block", "code": "game:door-solid-*", "name": "wood" } }, "output": { "type": "block", "code": "game:door-sleek-windowed-{wood}" } } The recipe above will accept any solid door variation as ingredient "D", save the content of "*" in the variable called "wood", which in turn can be used to output the exact same value, making the creation of recipes much easier and resource-friendly because in this example you don't have to create 12 recipes for the Vanilla woods, but only one.
  11. Nice! A little tip so that the super root will show up in the Creative Inventory and the handbook. Replace "creativeinventory": { "category": [ "food" ] } with "creativeinventory": { "food": [ "*" ] }
  12. Hello, hello. Both soil types are blocks, not items.
  13. Hey there. When working on mods it is always a good idea to keep an eye on the logs for any potential errors or warnings popping up. It's mostly "client-main" and "server-main" you want to keep an eye on. You can find them in "%AppData%\VintagestoryData\Logs". Your mod got two warnings. [Warning] Did not find required shape rootstew:shapes/item/food/rootstew.json anywhere. (defined in Shape for item rootstew:rootstew) [Warning] Texture asset 'rootstew:textures/item/food/rootstew.png' not found (defined in Item rootstew:rootstew). The first warning is fairly self-explanatory. Your mod doesn't come with a shape. That means that even if your texture would be working, the game would have no way of displaying it. The second warning tells you what is wrong with the texture. The game is expecting a .png file, while you are supplying a .jpg.
  14. It'd help to know what those forays actually are. I know of https://mods.vintagestory.at/purposefulstorage but it might be a mod which is already on your list.
  15. Most likely this one:
  16. Ah, now I understand your problem. It has been a while for me. Yep, you have to save the page first. That page will be in Draft mode, so people won't have access to it. You've got all the time in the world to fill out all the details.
  17. If I had to wager a guess I'd say that it's most likely "drtagx" causing the issues. I don't see any other mod that'd touch the moon except the shader.
  18. That's part of the domestication process. The wiki has more information about it: https://wiki.vintagestory.at/Animal_husbandry#Domestication Generation 10 animals shouldn't have any fear towards you.
  19. If you bought this one I am afraid that you cannot install mods.
  20. I feel inclined to let you know that I appreciate the effort of hosting such contests, in case the resonance isn't as big as desired. I am just not capable enough nor do I have the imagination to come up with something that could fit the bill.
  21. The Resonance Archive has a Surface entrance.
  22. Those look like Primitive Survival's whisps. They are basically like Vanilla butterflies in terms of functionality (minus the fact that you can't catch them, iirc).
  23. People tend to generate their worlds in Single Player and upload those to their servers. https://wiki.vintagestory.at/index.php/Guide:Dedicated_Server#Customize_world
  24. armor-head-scale-steel, armor-body-scale-steel, armor-legs-scale-steel But honestly you probably just want to go into Creative mode with "/gm 2", open the Creative Inventory and your character sheet and simply drag and drop your armour pieces onto your character. After that you can switch into Survival with "/gm 1".
×
×
  • Create New...

Important Information

We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue.