Djinn System Script v1.1a

What is it?
This script allows the user to create and use Djinn similar to the game “Golden Sun”.  Djinn act as a “special piece of equipment” that can be used in battle to perform a special skill.  Djinn have 3 states: Equipped, Standby, and Cooldown.  When a Djinn is added to the party it starts out in standby.  A djinn on standby provides no special effects and must be equipped, either via the main menu option, or by selecting it from the menu in battle.  A djinn that is equipped provides special bonuses to the player based on what the piece of equipment does.  An equipped Djinn may also be released in battle to perform the skill associated with it.  A Djinn released in this way enters standby.  Cooldown has to do with the other ability in the game.  Djinn on standby can be used to perform a special kind of summon.  Djinn used in this way enter cooldown for a certain number of turns.  After the cooldown is over, they go back to the equipped state.

How can I use it?
This script works with a few note tags that get placed into skills and equips.

Equip Tags:

  • <fire djinn 80> – This tag consists of 3 parts.  The first is the name of the element the djinn belongs to, in this case “fire”.  Elements are set in the config section of the script.  The second is the word “djinn”.  The third is a number.  This number relates to the skill that gets used when the djinn is released, in this case, skill ID 80.

Skill Tags:

  • Skills are slightly different and use a several line tag.  To do this, you start out with the tag <summon>.  After this you put the summon costs for the skill in the format “# element”, for example, to cost 2 fire djinn you would use “2 fire“.  Finally, you finish with </summon>.  As an example, a skill that requires 2 water djinn and 3 earth djinn.<summon>
    2 water
    3 earth

What does it look like?
This shows the summon window in battle.  Rather than skill costs, Djinn costs are displayed and the colour changes based on whether the cost is met or not.  Also note the window that shows the Djinn on standby.
Posted Image

This shows the menu scene to equip or unequip Djinn outside of battle.  Changes to stats are displayed up top.Posted Image

What does it work with?
This script adds commands to the menu and battle scenes.  I will most likely work with any battle system that keeps the Window_ActorCommand class mostly intact and any menu system that leaves the Window_MenuCommand class mostly intact.

This script is designed to work with CP’s Battle Engine version 1.2 or higher, but is compatible with older versions.  In version 1.2 of CPBE there are additional block tags that add the menus to the actor command window.  There are :djinn and :djinn_summon.  See the instruction section in the script on how to use these.

How can I get the code?
Version 1.1 (base script, 1.20.2013) is available from my pastebin account here or my mediafire account here.

I would like to use this code.
Creative Commons License
This work is licensed under a Creative Commons Attribution-NonCommercial 3.0 Unported License.
Permissions beyond the scope of this license may be available at

Author’s Disclaimer:
So I decided one Sunday that I wanted to make this script.  No clue WHY I wanted to make it, I just did.  And so I did.  I guess this is what you call “practice”.  I had no reason to make it.  I didn’t need it.  No one asked for it.  I just made it.  And it turned out surprisingly well.  There have been some small issues with it, mostly lag which I am working to iron out of the system, but overall it runs quite excellently.  I’m not sure if I want to add the class system that Golden Sun uses, but I do have certain provisions in the script to make it easy to add if I choose to.  As always, enjoy!

  1. You have very cool scripts! The only problem I find is that I cannot donwload them from pastebin, it always says that the page doesn’t exists. I hope you can fix that and also I would like to see more of your work!

  2. Hello this is a good script but I am having trouble with the damage the actors can do to the enemies. Even if I set up a weapon to the maximum number of attack it doesn’t add it. How do you use the defeault damage coculations my characters shoudln’t be lv80 only doing 320 damage. Please tell me how to fix this?

  3. Hi! I really enjoyed your djinn script, but I’d like to ask you if there is a way to change class of a actor based on the quantity of djinn of certain element. Example: 2 earth – class 1; 2 fire and 2 water – class 2; 8 wind – class 3 ….
    Thank you!!

  4. I keep getting an error whenever I double-click ‘Enter’ on a blank space in the Djinn menu.

    Script ‘Djinn’ line 1006: NoMethodError occured.
    undefined method ‘[]’ for nil:NilClass

    Any idea what the cause could be? I have my Djinn set as ‘Body’ armor for the sake of placement.

  5. Blunderpusse

    Any plans on making an MV version of this script/engine?

Reply to this post

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: