In this page, you will be able to follow an small tutorials about making your own shard in JSON and play it with Cyberscript.

It will be an long but fully complete tutorial. At the end you will be able to see the described shard.

To start, you need:

• 📄 Text editor : VS code, Notepad (hard but possible) or Notepad ++ (my favorite). Along with Notepad++ you need a Json Plugin for it as well.
• ✍️ Knowing fundamentals of JSON (read it, it's easy 😀 ) here
• 💯 Read the fundamental about Cyberscript: Scripting Basics
• ✔ an JSON validator website (for be sure that your json is not malformatted, because it will not compile if) JSONlint
• 🧠 a Brain, that work not that bad :)
• 🥇 Cyberpunk Game with Cyberscript installed and working
• ⏲ Patience, you will discover a new thing. It require patience and trial and error before it works.

Ok now I will assume you have it all. let's start !

We assume here that you already create an mod folder
We will create .... Shard!

📂 Setup the folder

First : in your mod folder, create a folder named "shard". It will contain every shard script of your mod. Logic !

In this folder, create a JSON text file, like for example : amazingshard.json

Open it with your favorite text editor.

💀 Write the shard skeleton

Now we have a blank page. But don't worry, we will fill it step by step.

Let's talk about shard structure :

A shard is a text. :

• A tag : Cyberscript will know it by this.
• A title : the title of the shard in the list
• A description : the content of the shard
• Crypted : determine if the shard is scrypted or not ? (WIP)
• New : determine if the shard will be tagged as new or not ?
• locked : determine if the shard will be showed in lsit or not ?

Now let's make it in JSON :

	{
		"tag": "myAmazingShard",
		"title": "My amazing Shard",
		"description": "Cyberscript is amazing \nHow I lived before know it ?",
		"crypted": false,
		"new": true,
		"locked": false
	 
	}

Note that i use "\n", it means break line !

Shard are called through an action or directly in shard journal menu if unlocked , under CyberScript Section.

you can follow this tutorial to make an interact : How to make an custom Interact ?

There is a small example that will work :

{
	"name": "Test My Amazing Shard",
	"tag": "myamazinginteractshard",
	"display": "event_interact",
	"type": "interact",
	"sorttag": "none",
	"trigger": {
		"mytrigger":{
		"name": "auto"
	    }
	},
	"requirement": [
		[
		"mytrigger"
		]
	],
	"action": [
		
		 {
			"name": "shard_notification",
			"title": "placeholder",
			"desc": "placeholder",
			"duration": 4,
			"iscrypted": false,
			"shard": "myAmazingShard",
			"helper": "This action will make display a shard notification. shard is optional (leave empty if not need, if not empty it will load an custom shard in the popup)",
			"helperTitle": "UI : Shard Notification"
		},
		
		
		]
}

You will have a shard notification that will show. then you click on read shard for open an popup that show it !

Prior to this version, you can directly open an popup that will show the shard content

{
	"name": "Test My Amazing Shard",
	"tag": "myamazinginteractshard",
	"display": "event_interact",
	"type": "interact",
	"sorttag": "none",
	"trigger": {
		"mytrigger":{
		"name": "auto"
	    }
	},
	"requirement": [
		[
		"mytrigger"
		]
	],
	"action": [
		{
            "name": "open_shard",
            "tag": "myAmazingShard"
        }, 
		
		
		]
}

You will have a shard popup that will open !

Copy your whole mod folder in (GOG or steam game folder)/Cyberpunk 2077/bin/x64/plugins/cyber_engine_tweaks/mods/cyberscript/mod/

so it should be in our case (GOG or steam game folder)/Cyberpunk 2077/bin/x64/plugins/cyber_engine_tweaks/mods/cyberscript/mod//myAmazingmod

the structure of the folder should be

📂myAmazingmod
├── 📃 desc.json
├── 📃 init.lua
├── 📁 libs
├── 📁 scripts
	├── 📁 shard
	|    └── 📃 myAmazingShard.json
	└── 📁 interact
	     └── 📃 myamazinginteractshard.json

Select the mod "myAmazingmod" in cycle interact (What are you talking about ?)

then hit the key for use your interact. Dialog should show !

• Creating Content with Cyberscript