tdtoolbox / btdtoolbox Goto Github PK

Open sourced Bloons Tower Defense Mod Maker

License: GNU Lesser General Public License v3.0

C# 100.00%

jet mod btd-toolbox json-editor btd btd5 btdb modding modding-tools csharp btd-battles mod-maker coding tool toolkit toolbox json game jetviewer-window

btdtoolbox's Introduction

BTD Toolbox

a fully featured mod maker and .jet editor for BTD5 and BTD Battles

Downloading

Get the latest release here
Extract the archive into an empty folder
Run BTDToolbox.exe

Usage

In this section youll learn how to use BTD Toolbox

Creating/Opening a project

To create a project, click File -> New -> Project from .jet Or alternatively, if you already have a project, File -> Open -> Existing project

Creating a mod

Now you should see a new "JetViewer" window. In here is where youll find all of the .json files for the game. You can use CTRL+F to search for folders in the JetViewer's treeview. Expand the project tree until you reach a file you need. Double click on any .json file in the file view to open the json editor. The json editor will check to make sure your json is valid. if your json is valid, youll see this:

otherwise, youll see this:

Testing a mod

Awesome! You've changed the files and want to see the result, sweet! To test, ensure you only have ONE JetViewer window open. This window's project will be compiled for the testing. Now, simply click Launch on the main window's menu bar.

Your mod will be compiled into a .jet and the game will be launched with your mod. If you dont have a backup of your .jet, the program will save one in the Backups folder regardless if its a legitemate .jet or not.

Exporting a mod

Want to share your mod? Soon there will be a patch launcher for multi-mod support and easy mod installation, but until then, Click on "Save .jet" (CTRL+S) in the JetViewer window and then pick a spot to export the .jet Give out your modded .jet to whomever and have them place it into their game's files.

Debugging & Future features

There are still unfinished features inside, so you might encounter bugs. Let us know if you find any

Learn how to make mods for BTD games:

The devs of BTD Toolbox made a modding tutorial series on YouTube, to teach you how to make mods! You can find it here

Help

Need help? You can ask for help here, all of the developers for the program can be found here.

btdtoolbox's People

Contributors

Stargazers

Watchers

Forkers

btdbattle griffmonst yassin889 jacobjdf1

btdtoolbox's Issues

Add ability to rename files

restore json editor when program restarts

Json Editor and Jet Form get bigger each time program run

The sizes are stored in a config file, and each time the editor or jet form is opened they are resized bigger. Currently the Jet form's size code is commented out, but not for json editor

put name of current file in title of json editor

Add ability to delete files

Make resize button much more obvious

Add common keyboard shortcuts

Ctrl + Z
Ctrl + F
etc

Control font size in JsonEditor

Text box and basic function is set up. Change not applied when value is changed in text box. I believe it would need to re-render the text currently inside the editor

Console window doesnt save config

Make sure user can only open proj_ files

Open project folder option

An option to open a folder as a project so work can be saved without needing to export the .jet

Create configs if they don't exist

Need to be able to check if the configs exist, and if not, generate them before the program does anything else

Add Ability to spritemap xml files

The ability to chart down sprites instead of manually doing it would be nice.

Add ability to create new files

Program doesn't exit when pressing exit button

When pressing the exit button, if the console is open, it will hide the console, then not exit. You have to wait a few moments and then press the exit button again in order for the program to close.

Fix multiple projects showing on restart, if you closed one of them

If you have multiple projects open in the editor, and you close one, say because you are done with it and dont need it for a while, it will still re-open the next time you run the program

Need to be able to open folers in JetExplorer list view

Scroll in text editor

Add a scrollbar to the text editor

add tabs to json editor for simultainious open files

create settings window to control more settings

exception handle if no font in configs

Cheat sheet

A form thay shows all sorts of useful information that would come in handy while modding

Undo and redo for editor and jet explorer

Need to be able to undo and redo any changes made in the JsonEditor, as well as in the Jet Explorer. A use case of the Jet Explorer would be if you accidentally deleted a file.

Make sure user cant search past text length in editor

Cant open files that we're edited in a previous session

If you open a file, make any edit, and close the program, you will not be able to open that file ever again.

Json prettifier

Prettify files when they are opened

save position in treeview and list

JetExplorer List View sort by "Name, Type, Last Modified"

Add ability to duplicate existing files

Save sizes for JetForm TreeView and ListView

Add exception handling for opening empty text document or folder

Both exceptions are here:
https://docs.microsoft.com/en-us/dotnet/api/system.io.file.readalltext?view=netframework-4.8

add find feature in Jet Explorer

Custom theme json editor's title and such

Ability to name projects

Since users can have multiple projects, they need to be able to name them so they know which is which.

add find and replace feature to json editor

Add way to use external editor

Possibility of anchoring windos, JetForm for example, to a side of the Main form

Make some of the windows anchorable

Possibility of anchoring windos, JetForm for example, to a side of the Main form

Remove scroll bars from MainForm

Will help when users are setting up their environment

JetExplorer getting smaller with each re-open

Change find and replace window based on if they are finding or finding and replacing

Check to see if file is already open in Json Edior

Add config with window sizes and font sizes

When program is re-opened all of the previous settings are the same

Add find menu on a seperate thread

At start ask if you want to open last project

needs to be able to tell if this is first use or not

Make browsing for existing projects easier

since all projects are in the same folder, pressing the "Browse for existing projects" button should open up to the projects folder

Add undo and redo to json editor

Custom layout presets

A folder will contain a bunch of layout.json files, just with different names. On the main window doing layout -> save layout will prompt to save a layout.json with the position of all the sub windows. You can place any .json inside that the user may have recieved inside the folder and then after they restart the program, it will appear as layout -> filename.json under the layout tab in the main window.