StoneJam 3: Into the Unknown

Join the Stone Story community as we kick off November with the return of Stone Story RPG’s jam event!

Over the past few months, we’ve added a vast array of new features to Stonescript, pushing the boundaries of what is possible in Stone Story. Take part in StoneJam 3 and show off your creations!

You can find a full list of changes to Stonescript at the bottom of this announcement.

What is Stonescript?

Stonescript is a scripting language built into Stone Story RPG, used for modifying the character's AI. Easy to use yet powerful, scripts can be as simple as automating potions if your health gets low or optimizing combat to super-human levels.

Stonescript can also be used to manipulate a number of in-game elements, like the UI or player cosmetics. Put your avatar in a flying mecha, give them a fancy hat, or create a dynamic healthbar!

If you’ve not yet explored the Mind Stone or need a refresher, check out the Stonescript tutorial we’ve written up here: https://stonestoryrpg.com/stonescript

What is StoneJam about?

With each new update we continue to expand what's possible with Stonescript. We want to see what YOU can create! Some of the projects that people have made with Stonescript include:

• Minigames
  
• Combat scripts
  
• Animated pets and cosmetics
  
• Custom UI elements
  

Collaborations between participants are more than welcome.

Previous StoneJam Entries

Disco Visor by Fyda

Stonemon by DarkLucifer69

SSRPG Idle by Fyda, raeborga, and Ace

What do I get?

For StoneJam 3, all participants will receive a secret reward given out at the end of the Jam! We're also introducing an optional theme that you can use as inspiration for your projects.

Our favorite submissions will be invited to be an official addition to the game, allowing players to activate your script with a simple “import” command.

Submissions will be judged based on the following categories: Useful, Beautiful, Stability, or Epic.

StoneJam 3's Theme is: Into the Unknown

When is StoneJam?

StoneJam 3 will take place from now to Monday, November 9th. You’ll have all of that time to create and submit your scripts on our Discord server.

How do I participate?

StoneJam 3 will be hosted on our community Discord server. You'll need to have the @stonejam role, which you can get by going to the #commands channel and typing !stonejam.

Two new channels will be created for this event. Use #stonejam3-discuss for all discussion about the jam and reserve #stonejam3-submit for submitting entries.

How do I submit my StoneJam entry?

Submission rules:

1. Inside your scripts, at the beginning of each file include:
- Name/nickname of author or multiple names if multiple authors
- Version number of the script
- Instructions on how to use it

2. Drop your script into #stonejam3-submit, along with screenshots and/or gifs of your entry in action.

3. If a single entry involves multiple interdependent scripts, put them into a zip.

4. Submit different entries separately.

5. You can submit scripts created prior to the jam, as long as the jam week is used for meaningfully improving them.

Resources for StoneJam

Stonescript Documentation

To see a full list of all possible functions, commands, and variables: https://stonestoryrpg.com/stonescript/manual.html

Example of what high-level scripting looks like

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

Easy projects

Introduction to Stonescript - This writeup gives you an overview of Stonescript's functionality, including variables, commands, and operators: https://stonestoryrpg.com/stonescript

Modding Guide - This walkthrough shows you how to import external scripts into the game. https://steamcommunity.com/sharedfiles/filedetails/?id=2003221477

ASCII-art Tutorial

Video tutorial: https://www.youtube.com/watch?v=o5v-NS9o4yc
Follow-along Reference: https://stonestoryrpg.com/ascii_tutorial.html

Reference guides

All ASCII characters currently available to use in-game: https://cdn.discordapp.com/attachments/597668520888762388/683419636204699676/AvailableGlyphs.txt

Hex for all enchantment colors:
Cyan: #02e5ff Yellow: #ffff62 Green: #32da5a Blue: #0063ff Red: #ff2222

List of valid ?loc:
rocky, deadwood, cave, shroom, haunted, crypt, bronze, icy, temple, nagaraja

Changes to Stonescript

There have been several changes to Stonescript over the past few months. All new additions have been added to the Stonescript manual, but they are compiled here for ease of viewing:

Arrays

• Used to organize values and objects into a single variable
  
• E.g. Headphones that generate notes (by link2_thepast) - https://cdn.discordapp.com/attachments/597668520888762388/769777336471388210/Headphones.txt
  

Permanent storage

• Values that persist when you leave a location or turn the game off. Exists separately from your primary save, so import scripts can access storage independently.
  
• E.g. Recording goals or achievements such as High Score or Times Played.
  

foe.state & foe.time

• Numbers that represent a foe’s current state and the number of frames in the current state
  
• E.g.
  ?foe.state = 2
  what to do in state 2
  

screen.i & screen.x

• The screen's position in-game, as an index that increses when the player reaches the right-side and it slides over.
  
• E.g.
  >`0,0,Screen index = @screen.i@
  

disable loadout input & enable loadout input

• Prevents/Restores weapon loadouts from being saved or recalled with input keys.
  

buffs.count & foe.buffs.count

• The number of buffs (positive effects) on the player / the foe being targeted.
  
• E.g. Can be used to trigger a loadout swap when an enemy reaches a certain number of buffs.
  

buffs.string, debuffs.string & foe.buffs.string

• A composite of information about all buffs/debuffs on the player/enemy.
  
• E.g.
  ?buffs.count > 0
  >`0,1,Player buffs = @buffs.string@
  

item.CanActivate()

• Returns true if it's possible to activate item abilities. False otherwise.
  
• E.g.
  ?item.CanActivate()
  equip Bardiche
  activate R
  

item.GetCooldown()

• Returns the remaining cooldown time (in frames) for a given ability.
  
• E.g.
  ?foe = boss & item.GetCooldown("bardiche") <= 0
  equip bardiche
  activate R
  

string.Equals()

• Takes two string parameters and returns true if they are exactly the same. Returns false otherwise. Case sensitive.
  
• E.g.
  var a = "foo"
  ?string.Equals(a, "foo")
  >The strings are equal
  :
  >They are NOT equal
  (The strings are equal in this case. string.Equals() evaluates to true)
  

totalgp

• The total "Gear Points" of your inventory, calculated from item star levels and enchantment bonuses.
  
• E.g.
  >My gear points = @totalgp@