Starbound

Starbound

CityScaper 2.0 - Building Made Easy!
This topic has been locked
Neb  [developer] Apr 7, 2023 @ 11:13am
OUTDATED Custom Modules - Tutorial
THIS IS OUTDATED BUT STILL WORKS
A new tutorial is coming soon for the new update to fully utilise all the features!

The system allows for custom modules, which add more content to the system!

This may be helpful:
https://steamcommunity.com/sharedfiles/filedetails/?id=2574693146

You will need
  • This template![github.com]
  • If you are creating a new dungeon from scratch, you will need Tiled - see my guide for more info
  • A text editor that is not windows notepad, I suggest Notepad++ but feel free to use anything you're familiar with, this is just JSON you are editing, not real code.
  • An image editor, or art program. I suggest paint dot net, however any will work as long as it supports transparency and is not GIMP.
  • A brain, this is necessary for most actions but if you do not have one, feel free to ask for help! I will help if I get time!

New Modules
Before we begin, all instances of MODNAME must be the same!
  1. Start by downloading this patch template[github.com]
  2. Navigate to
    /interface/scripted/cityscaper/modules/
  3. Rename the folder MODNAME with your mods name. *
  4. Enter the icons folder and name MODNAME with your mods name. Change the icon to be whatever your like, but avoid changing the size of it to avoid inconsistencies and conflicts.
  5. Return back to the modules folder, and open
    neb-cityscaper-modules.config.patch
    in your text editor.
  6. At the top of the file is a template that is also attached here.
    { "shortDescription": "Your Dungeon Name", "dungeonSize": [5, 10], //the x, y size of the dungeon "dungeon": "PREFIX-YOURDUNGEONNAME", "previewImage": "/interface/scripted/cityscaper/modules/MODNAME/PREFIX-YOURDUNGEONNAME.png", "cost": { "money": 50000, "essence": 10000 } }
  7. Replace PREFIX-YOURDUNGEONNAME with the dungeon that this specific one will be adding, and place it under rooms, prefabs or dungeons. **
  8. Adjust the costs to what you believe it should cost for your item.
  9. Navigate to
    /dungeons/cityscaper/
    and place your dungeon in whichever folder it belongs in.**
  10. Ensure the dungeon name matches the PREFIX-YOURDUNGEONNAME from earlier.
  11. If your game is open, do /reload, and your changes will be applied! If the game crashes or your file does not appear, you likely made an error! See troubleshooting for more info.
* Try to have a prefix, such as neb- to your mod, I use neb- as this is my name and signature. This prevents conflicting mod names. For example, neb-shellguard. If you do not do this, your content will be merged with other modules of the same name which means they will appear in the same list, or may overwrite each other. This can be intended on your end.
** Rooms are singular rooms, Prefabs are prebuilt houses, or parts of bigger houses, while Dungeons are full builds, like dungeons or full built mansions.

If you are a mod developer of your own mod, you can add compatibility built into your mod with test patches, however as I do not know the ins and outs of these yet, I will have to get back to you on how to do that later.

Troubleshooting
While modding you will encounter errors, its guaranteed since nobody but me is perfect.
If you encounter an error, go to your local files, navigate to
/storage
and find the file called
starbound.log
ENSURE THERE ARE NO NUMBERS, these are old versions of the log and will not contain the error. Scroll down to the bottom and find the line that has ERROR at the start of it, and read it, it will usually tell you which file failed. Then take it to a json linter and see where you went wrong!

Closing Statement
This guide will be updated when I get more time, thanks for reading!
Last edited by Neb; Mar 23 @ 2:31am
< >
Showing 1-10 of 10 comments
76561199037270116 Apr 13, 2023 @ 11:15pm 
hi, I'm Russian and I'm glad that such a convenient mod has appeared, I'll be waiting for additions for the arcana, I'll be glad if you make a rusafekator, I appreciate your efforts, your mods are useful, I installed a couple of thanks.
Neb  [developer] Apr 14, 2023 @ 3:38am 
Thanks!
Wyntr Stardust Jun 13, 2023 @ 4:00pm 
hey the link to your template has been flagged as malicious and no longer works. can you post a new link i want to make modules for your mod
Wyntr Stardust Jun 13, 2023 @ 4:10pm 
Hey sorry if this is a double post i cant tell my browser is messing up. but anyway, your link for the template has been flagged as malicious by steam and no longer works. can you please post a new link? i would love to make modules for this mod
Neb  [developer] Jun 13, 2023 @ 11:02pm 
The link still works, I cant seem to find any issues with it. It takes me to a "you are leaving steam" page.
Last edited by Neb; Jun 13, 2023 @ 11:04pm
Kimishiki Sep 26, 2023 @ 5:16am 
why look down on poor gimp? i love it. it has modded support just like notepad++
Neb  [developer] Sep 26, 2023 @ 7:04pm 
So does paint dot net.
林一二 Jul 11, 2024 @ 10:29am 
Hi, the current tutorial seem to only about adding metadata, but how to add real blocks? I know it can be draw using the Tiled app, but how to config it and where to place the result? Thanks.
Neb  [developer] Jul 11, 2024 @ 10:40am 
This mod and tutorial is completely unrelated to Tiled and blocks, sorry.
I suggest referring to my guide for help on that, or the discord servers if you need more help.
林一二 Jul 11, 2024 @ 11:00am 
I see, a complete tutorial is at https://steamcommunity.com/sharedfiles/filedetails/?id=1660027998 , saw this on your discord server's resource channel.
< >
Showing 1-10 of 10 comments
Per page: 1530 50