Brigand: Oaxaca

Brigand: Oaxaca

Not enough ratings
Brigand Modding Guide
By brianlancaster45
More information about modding stories or making your own stories with the Brigand Scripting Language (BSL).
   
Award
Favorite
Favorited
Unfavorite
Intro
Very basic modding can be done with the F1 key, which opens the GUI editor. However, to make your own items, abilities, dialogue, AI, etc., you must learn the Brigand Scripting Language (BSL). These commands can be used with both the F2 command prompt, as well as in *.BSL scripts, which can be edited with Notepad.

The basics of BSL are covered in the Builder's Manual, as well as the story included with the Extras DLC, called MOD TUTOR. If you want to start modding, first play through that tutorial story. Below are some things not covered in either. This guide will be expanded upon in the future by request.
Modding the Original Story
The game will not let you overwrite the BRIGAND - OAXACA story, so you must change the story's name using the F1 editor or the F2 command prompt: "storyName=???". Then save. You will then need to copy the Assets folder of BRIGAND - OAXACA and rename it to your new story if you want all the scripts to be the same. You can then modify all the scripts and resources in that Assets folder for your mod. For any files that don't exist in your story's assets folder, the game will use the files from the DEFAULT Assets folder.
Creating a New Story
Use the F2 command prompt and type "newStory=???" to start a new story completely from scratch. It will use the assets in the DEFAULT folder if you choose not to create a new folder with your story's name.
Importing/Exporting Models
Models are *.X files, but you can convert them to *.3DS using the DBO Converter under "Stuff\Programs Redist" folder (with Extras DLC). This will make them load a little faster between maps, but it's not necessary. You can find all the original *.X models files in the "Stuff\Objects X" folder (with Extras DLC).

Most modelling programs can import/export *.X model files.

For UV mapping, I used Wings3D: http://www.wings3d.com
Animating Characters
Objects of type "sentient" (see Builder's Manual) have different animations that are stored in 5 separate X files, so each animation must be in a separate file. These include the idle animation, which is named after the object's tag/folder (example: android.dbo or android.x). You should also have the Attack animation (androidAttack.x), Fall (androidFall.x), Hurt (androidHurt.x), and Walk (androidWalk.x). The source code will combine them all when the game runs.

Personally, I've never animated my own models, but Quadrajet has done it. Here are his instructions: "I use Fragmotion (http://www.fragmosoft.com/) to import the .X files and edit the animations, export the animated objects as a .Ms3d file. Then I import that file into Milkshape3D (https://archive.org/details/milkshape-3-d-1.8.4), and finally export each range of keyframes into Brigand." Hope that helps.
Changing the Basics (Skills, etc.)
If you want to change object properties, edit the INI script in the object's folder, in your game's assets folder. However, this will not change objects that have already been loaded into the story. You can use the command "resetStats" (see Builder's Manual) to reload the INI scripts for all objects of the given tag/folder.

If you change the names of skills, status effects, abilities, etc. in the globals.bsl script of your story's Assets folder, you will also need to change every instance of it referenced in the scripts. Don't worry, you can use Notepad++ to find and replace skill names, etc. in every *.BSL file in your story's Assets folder at once. This is how translator for the NIGHTMARE (ES) story translated all the skill names, etc.

Notepad++: https://notepad-plus-plus.org/downloads/
Video Tutorials
Video #1: Make basic objects (box and cone), change object position/angle/size/texture/material, set polygon collision, save game

https://www.youtube.com/watch?v=hFCx-dLWR2s

Video #2:
Make basic objects (tube, ball), scale skin, import objects, give equipment, how to die in rocket explosions

https://www.youtube.com/watch?v=RgJe83viXAQ

Video #3: Asset folders, mod the main story

https://www.youtube.com/watch?v=XtmMfYA23MA

Video #4: Make a new story, change map properties with F1

https://www.youtube.com/watch?v=daeHRKzqqiQ

Video #5: Change map properties with F2 editor, edit ground/cliff matrix with F1 editor

https://www.youtube.com/watch?v=J2FFJi7OFRo

Video #6: Edit terrain with the F1 editor (easier)

https://www.youtube.com/watch?v=5nqL7f_24eA

Video #7: Change ground and cliff textures, change skybox, change water level

https://www.youtube.com/watch?v=rMpk2FQYQlE

Video #8: Open Builder's Manual, teleport player to new map, name and save a new map, teleport other objects

https://www.youtube.com/watch?v=s-ZIJZnT1Xk

Video #9: Change map music, call system scripts (makeRiver, makeTree, makeBuilding)

https://www.youtube.com/watch?v=0HoHnK8EoQQ

Video #10: Name and save story, make story assets folder, make new map script

https://www.youtube.com/watch?v=LUxUKHuv1_U

Video #11: Link map edge to new map, make new character, copy default character assets to new story assets

https://www.youtube.com/watch?v=XywpmD7whII

Video #12: Conversation scripts

https://www.youtube.com/watch?v=eFBXrJe_I00

Video #13: Conversation scripts (continued), player dialogue choices

https://www.youtube.com/watch?v=2B5BIXgqbVc

Video #14: Conversation scripts (continued), variables, booleans

https://www.youtube.com/watch?v=ThWjOuDUb9Q

Video #15: Make door, reset variables, save game (again)

https://www.youtube.com/watch?v=H71AAG6DOiI