![]() |
Adventure Creator
1.78.0
An adventure game toolkit for Unity, by Chris Burton, ICEBOX Studios 2013-2022
|
Welcome to Adventure Creator's scripting guide. You can use this guide to get detailed descriptions on all of ACs public functions and variables.
Please read this page before delving in!
Adventure Creator's scripts are written in C#, and use the 'AC' namespace, so you'll need to add the following at the top of any script that accesses them:
Accessing ACs scripts is very simple: each component on the GameEngine and PersistentEngine prefabs, as well as all Managers, can be accessed by referencing their associated static variable in the KickStarter class, e.g.:
Additionally, the Player and MainCamera can also be accessed in this way:
The KickStarter class also has functions that can be used to turn AC off or on completely:
You can detect the game's current state (cutscene, gameplay, or paused) from the StateHandler:
If you want to place the game in a scripted cutscene, the StateHandler has functions for that, too:
All-scene based ActionLists, inculding Cutscenes and Triggers, derive from the ActionList class. Action List assets rely on the ActionListAsset class. Both classes have an Interact function, which will cause their Actions to run.
Global and Local variables can be read and written to with static functions in the GlobalVariables and LocalVariables classes respectively:
The best way to hook up custom code with AC is to use the EventManager. Custom events allow you to hook up your own code whenever AC performs common tasks, such as playing speech or changing the camera. A tutorial on writing custom events can be found here.
If you're using this guide to help write an integration script with another Unity asset, check out the Integrations page of the AC wiki - it may have what you're looking for!
More common functions and variables can be found under Section 12.7 of the AC Manual. Happy scripting!