What are Plugins? - BakinWiki

What are Plugins?†

Plugins are features that extend the functionality of Bakin's tools and engine programmatically using C#.
There are two main types of plugins:

Tool Plugins (.dll format)
Engine Plugins (.cs format)

As of March 2025, only engine plugins have been released for the creation environment.

↑

Plugin Types†

Engine plugins are used to extend the operation of the Bakin engine.
The engine plugin currently has the following two types of functions:
- Event Scripts: Extend the functionality of events by assigning C# programs to them
- Battle Plugins: Replace Bakin's battle system with a C# program

↑

How to Use Plugins†

For engine plugins, create the folder specified in the description below directly under the project folder you are editing and store plugins in it.
- Event Scripts
  - First create a 'script' folder and add the .cs file to it.
  - After launching Bakin, click the arrow in the "C# Program Assignment" field on the lower left of the event sheet.
  - Select the script you wish to assign from the list that opens.

Plugins with multiple methods can use the event panel to specify which method to apply.
See Control for the "Call C# Program" panel.

Notes
cs files can also be stored in subfolders.
Note that the dll file must be placed directly under the script.

Battle Plugins
- Create a 'battlescript' folder and add a set of .cs files to it.
- It is applied automatically when the project is launched, and no tool operation is required.

↑

Delete Plugins†

Event Scripts: Delete the .cs file you wish to remove from the 'script' folder.
Battle Plugins: Delete the entire 'battlescript' folder.
You can also use "Remove Battle-Related Scripts from Game File" in the Map Editor's top menu > Functions > Expanded Features.

↑

How to Create Plugins†

(!)Bakin updates may affect the operation of plugins created in the past. Please check the differences each time an update occurs.

Event Scripts
After launching Bakin, click the arrow in the "C# Program Assignment" field on the lower left of the event sheet.
Press the "Create New" button at the top to start the editor (the editor associated with .cs).
- It is recommended that Visual Studio (Community version is acceptable) be installed with C# development ready.
- You can also use other editors to create .cs files and put them in the 'script' folder without going through Bakin.

Battle Plugins
Execute "Copy Battle-Related Scripts to Game File" in the Map Editor's top menu > Functions > Expanded Features.
See Map Editor Overview for more information on this feature.
When executed, a 'battlescript' folder will be created in the project folder currently being edited, and a battle plugin template (the same as the default battle process) will be created in that folder.
Edit the created file with your editor.

Metadata Settings
- No metadata in event scripts.
- For battle plugins, replace // @@version xx.xx.xx.xx.xx at the beginning of BattlePluginDef.cs with the corresponding Bakin version.

Plugin Help
If you distribute plugins and need to explain the contents, please create and include a readme.txt file.

Plugin Settings
There is currently no ability to specify plugin preferences.

↑

Key Points When Creating Plugins†

Link Any DLL
By making the following statement at the beginning of a C# program, you can link and use any DLL file in the script folder.
This feature can also be used to load DLLs in the script folder.
Please refer to "Introduce Steam "Achievements" into the Game" in Plugin Samples.
```
// @@link xxx.dll
```

Import Another cs File
You can import another cs file by making the following statement:
```
// @@include xxx.cs
```
Please use this option when a large process is divided into multiple cs files.
Refer to the battle plugins in "Battle Plugin Samples".
By inserting the above description into BattlePluginDef.cs in various places and incorporating the processing of branches and leaves, all battle processing is made the target of the build.

Access C# Assigned to Another Event
By using @ref and writing as follows, you can access C# assigned to another event.

Write the following for the cs file of another event you want to access at the beginning of the cs file
```
// @@ref OtherScript.cs 
```

Obtain target MapCharacter from mapScene

var chr = mapScene.mapCharList.Find(x => x.Name == "Name_of_Another_Event");

Access members of a class assigned to another MapCharacter through a cast
```
((OtherScript)chr.bindedScript).field = "ABC"; 
```

Resources Referenced Only from Plugins
If you have a resource that is referenced only from a plugin, you must specify that resource as the target for export.
To specify, right-click on the resource you wish to export in the tree of entries in the Resources menu, and then select “Be Sure to Include in Published Work Export”.

↑

Plugin Distribution†

Event Scripts: Distribute the created cs files in any way you wish.
Battle Plugins: Zip the entire 'battlescript' folder and distribute it in any way you wish.

↑

Distribution as .csrbr Files†

Compressing the event script .cs files and related files into a Zip file and rewriting the extension to .csrbr will make distribution and importing into Bakin easier.

They can distribute through the Steam Workshop.
In the event sheet "C# Program Assignment", click the Add button to select the .csrbr file.
Once added, the .csrbr file will be automatically decompressed and extracted.