Universal Combat CE

Universal Combat CE

 This topic has been pinned, so it's probably important
dsmart  [developer] Mar 18, 2017 @ 12:09pm
UCCE 3.0 GBS MODDING TOOLS
To make up for the long lull that's in progress due to the significant amount of assets that are
being created for this DLC, I have decided to release the scripting tools.

INTRO

The GBS (Game Builder System) includes the following:

  • PREPARE: script parser (the interpreter is built into the game and runs in real time)
  • BCSTUDIO: 3D model viewer
  • PTESTUDIO: Planetary scene viewer
  • PLAYMOD: Tool for modifying player game profile
  • Script sources for all scenarios included in UCCE 3.x
  • Sample scripts
  • Usage docs

This tool allows you to create brand new scenario scripts for both space and planetary regions or to modify the existing ones as needed.

*** WARNING ***

  1. Tools are only compatible with 3.0x (The Lyrius Conflict DLC) engine, as they may need to be updated along with the game itself over time.
  2. Tools are 100% unsupported. So if you nuke your installation, you only recourse would be to uninstall and reinstall the game through the Steam client.
  3. You cannot modify the game 3D models, scenes (space or planetary) etc, as I have not released those tools - and have no plans to do so at this time.

WHERE TO DOWNLOAD

GBS was original included in the latest Steam release, but have been removed and is now a separate download. There is currently no publicly available GBS for the 2.0 game.

GBS (3.0 standard)[3000ad.com]

GBS (3.0 Public Test)[3000ad.com]

HELP AND TIPS

The tools are 100% unsupported. But I will try to address issues, answer questions, as time permits.

If you look at the GBS_QREF.TXT file, the commands are all there. Though not all of them are used, they are self-explanatory. And reading GBS_DOCS.TXT also gives an overview of how the system works.

All the game's scripts for UCCE 3.0 are included and can be used as examples. Simply search for the usage of a command, in order to learn how to use it. If a command isn't used in any of the scripts, and it's use is not clear, then feel free to ask.

For all usage questions, please post a new topic for each question and with a descriptive subject. This way it is easy to locate and others can benefit from it.

Also, any INI file mentioned in the docs, is located in the .\DATA sub-folder where the game is installed.
Last edited by dsmart; Dec 8, 2018 @ 4:25am
< >
Showing 1-15 of 24 comments
dsmart  [developer] Mar 18, 2017 @ 12:12pm 
Later today, I will be posting an example of how to modify and run one of the existing scripts.
McTosh Mar 18, 2017 @ 12:17pm 
Nice, please do Derek. I'm going to enjoy fiddling with this tool.

Exciting release!
dsmart  [developer] Mar 18, 2017 @ 5:37pm 
I just pushed a new update that includes some new GBS files and removes some legacy ones which was accidentally included before.

The files are now in .\MODS\GBS.ZIP. If you had the loose files before, you need to delete all of them in order to ensure that you have the correct set. This ZIP file contains the correct set of files.

If you haven't yet, extract the .\MODS\GBS.ZIP archive to a folder OUTSIDE your Steam game install path. Do NOT extract this file in the game install folder or BAD things will happen when you start creating and building scripts. e.g. extract to C:\UCCE30_GBS or wherever you like.
McTosh Mar 19, 2017 @ 1:12am 
Thanks for the heads up, will do.

Got all day today to play and tinker!
Yskonyn Mar 19, 2017 @ 4:02am 
I have to fly today, but tomorrow I have lots of time to delve into it and the day after as well.
dsmart  [developer] Mar 19, 2017 @ 4:29am 
I have removed the GBS tools from the Steam distribution and moved it to the website instead. This will make it easier to update over time.

The new distro also contains some revised files. So be sure to download it, even if you had the previous version.

Also, I pushed a small Steam update; so be sure to get that. If all goes well, the .\MODS folder would have also been removed after that update.
Yskonyn Mar 19, 2017 @ 5:21am 
Heh, in between my last posting and yours I looked for the /Mods folder. Didn't find it, tried 'Verify file integrity' in Steam to see if it missed updating... Nothing. Big questionmark arose above my head and decided to re-read this thread. :P
Now its clear why I didn't find it and I can be re-assured I wasn't going insane there for a while. Lol!
dsmart  [developer] Mar 19, 2017 @ 11:41am 
I just now uploaded another update to the GBS.ZIP archive. You should download it.

I have made extensive revisions to the gbs_docs.txt and gbs_qref.txt files. The new versions have today's date (also noted at the top of the file).

I suggest using a tool such as Winmerge[winmerge.org] to diff the old and new files/folders if you want an idea of what I revised/added. It's a lot.

Remember that I have no intentions of documenting every single command or how it's used. That's why I included not only sample scripts, but also the source scripts that ship with the game.

So when in doubt, look up a command in gbs_qref.txt, then search for that command in the .\Scripts folder to see how it's used. You can use any grep search tools for this. My tool of choice is PowerGrep (it's a paid app); but you can use any freeware[alternativeto.net] ones such as grepWin[stefanstools.sourceforge.net], EFS[www.sowsoft.com]

Of course you can ask questions (don't do it in this thread, as it's only for my updates) if you run into problems. Just don't expect an immediate response.

WARNING: The batch files use a commandline FOR expansion that apparentlyno longer works in some versions of Windows. As I don't use the generic CMD console, I haven't bothered to correct the entries to make them compliant. As an old school dev, I have used JPSoft's console tools[jpsoft.com] for decades now. They don't have that problem.
dsmart  [developer] Mar 19, 2017 @ 5:27pm 
I have uploaded a new version in which I changed BUILDALL.BAT (which most of you won't need to use anyway) variable expansion to avoid it choking. So you can use the standard console command now; at least in WIN7 and WIN10.

NOTE: This problem only occurs in that batch file. The other BUILD.BAT file does not use variable expansion.
Last edited by dsmart; Mar 19, 2017 @ 5:28pm
MES3rd Mar 21, 2017 @ 9:38pm 
"Tools are only compatible with 3.0x (The Lyrius Conflict DLC) engine, as they may need to be updated along with the game itself over time."

So, the Scripting Tool is only usable if you buy the $30 DLC. Interesting...
dsmart  [developer] Mar 22, 2017 @ 7:43pm 
I have updated the OP.
dsmart  [developer] Jul 23, 2017 @ 6:11pm 
I have updated GBS with a new tool called PLAYMOD. It is a console app that lets you make modifications to your existing player profile. Read the PLAYMOD.TXT file for more.

- Copy the GBS\TOOLS\PLAYMOD\PLAYMOD.EXE file into your game install folder
- Open a CMD.EXE console with admin rights

NOTE:

It only works on the CURRENT profile which is set in the UCCONFIG.INI each time you exit the game.

So if you have been using e.g. profile 3 (the profiles are numbers 0-9) to play a game, and you want to restore settings for profile 0, you have to :

- edit the UCCONFIG.INI file in Notepad
- scroll to the bottom where you see PlayerProfile=
- change that value to the profile you want to use Playmod on
- save the file

e.g. if you have a saved game in profile slot 3, the file will show: PlayerProfile=4



Last edited by dsmart; Jul 23, 2017 @ 6:24pm
dsmart  [developer] Jul 24, 2017 @ 6:39am 
I have updated Playmod (updated PLAYMOD.TXT)
dsmart  [developer] Aug 11, 2017 @ 3:17pm 
I have updated Playmod which fixes an issue with it crashing/hanging when performing some personnel related commands.
Nemesis Bosseret Aug 14, 2017 @ 7:17pm 
omg there is still development going on i wrote this game off for dead almost a year ago lol. @dsmart i really do hope you complete it
< >
Showing 1-15 of 24 comments
Per page: 15 30 50