Modding/JSON Files

In Yandere-Simulator you can mod the game to create custom content and other cool things that would not usually be in the game. This page will give you tips, tricks and help from a JSON Modder (Ty-dere) if you wanted to create your own mod that includes editing JSON Files..

'''This page is allowed to be edited as long as your information is correct. '''

If somebody has asked a question and it has been answered, put it in the FAQ section.

Compatibility
When YandereDev releases a new build for Yandere Simulator, make sure you test your mod before saying it is compatible!

Before You Start...
Before even starting to create your mod, BACKUP YOUR FILES, and put the original somewhere safe where you can easily put it back into the game and won't forget where it is. Your desktop is a good choice. Here is the layout of my backup JSON files. (If making more than 1 backup, make sure you put the JSON in seperate files.)


 * Tip: Rename your folders after mods you are using. I have not done this in the picture as the "Used Backup" is a mod I have not released.

Handy Links when Modding:
'''The JSON editor I use is online and it is called JSON Editor. You can use Notepad or Notepad ++ If you have these.'''

(The wiki is not affiliated with this website or any programs mentioned. It is third party and we don't have control over it. Use at your own risk!)

Getting Started
#1 Modding Rule: Use your backups, NOT your Students.JSON in the YandereSimulator's StreamingAssets folder.

Note: In current builds, punctuation errors in the JSON files will give the player an error message upon spawning at school. If this happens check for extra/missing colons, quotation marks, or periods, and make sure all info is valid.

Right, without further ado, lets begin!

First go to a JSON site or Notepad (or Notepad ++) and begin. I am using JSON Editor Online (as mentioned earlier.)


 * Tip from Ty-dere: Use the right hand side! It has a cleaner interface for you to work with!

This is what the editor will look like after importing Yandere Simulator files:









<p style="font-weight:normal;">

<p style="font-weight:normal;">

<p style="font-weight:normal;">

<p style="font-weight:normal;">

Editing Key Info
<p style="font-weight:normal;">I had to trial and error creating mods as I had no guidance whatsoever, but I will make your life easier and give you all the key information.

Name:
<p style="font-weight:normal;">Note 1 - also works for the "Unknown" and "Reserved" students.

<p style="font-weight:normal;">Note 2 - removing the quotation marks around the name will cause KoharuHair to spawn.

<p style="font-weight:normal;">Note 3 - changing the student's name to "Unknown" or "Reserved" will cause the said student to stop spawning.

<p style="font-weight:normal;">Note 4 - Certain EyeColors/HairColors (Basu Sisters' Eyes, Pippi's HairColor, MaiWaifu's Eyes) will either turn out grey/white, or cause FunGirl's screen to appear and lie about Osana/Reserved!

<p style="font-weight:normal;">Displayed on student info screen and other screens that display the student's name. Anything that is typed will become the student's name.

Sometimes certain names will make the whole school appear as flaming ghost students, such as the name "Shimiro Shita" will do this.

Gender:
<p style="font-weight:normal;">Note 1 - male and female models have a different set of animations (Example: male students don't have an animation for texting, so they will instead start glitching out if the required animation doesn't exist).

<p style="font-weight:normal;">Note 2 - ''certain students will glitch out if their gender is changed. ''

<p style="font-weight:normal;">Note 3 - If you put another number besides 0 and 1 in this section,the game is going to be started in an empity school and the JSON alert will spawn on yandere- chan.

Class:
<p style="font-weight:normal;">Note - inputting an invalid ID will cause the student to become bugged.

Seat:
Note - inputting an invalid ID will cause the student, as well as all of the teachers, to disappear.

As of November 15th 2016 build, you can send students to different seats. Below is an image showing the seat IDs, what seats are occupied in the vanilla version of the game and what seats are not occupied in the vanilla version of the game. <p style="text-align:center;">

Clubs:
<p style="font-weight:normal;">''Note 1 - inputting an ID higher than 101 will cause the student to become taller and act as a teacher. (Female students only)''

<p style="font-weight:normal;">Note 2 - choosing the Occult Club gives the student a frowning face.

<p style="font-weight:normal;">Note 3 - choosing the Teacher Occupation gives the student the teacher model and behaviour.

<p style="font-weight:normal;">Note 4 - choosing the Gym Teacher Occupation gives the student the gym teacher model, animations and behaviour.

Personality:
<p style="font-weight:normal;">Note - inputting an invalid ID will cause the student to become bugged. <p style="font-weight:normal;">Note - despite being on this list, 0 technically counts as invalid <p style="font-weight:normal;">Note - putting certain persona's on certain students will cause them to spin after reacting to a murder (Ex:Yui Rio with Social Butterfly) 

Crushes:
<p style="font-weight:normal;">Note - inputting an invalid ID will cause the student's info screen to go blank.

Breast Size:
<p style="font-weight:normal;">Note - only available for female students.

<p style="font-weight:normal;">Breast size is the size of female students' breasts. Kokona Haruka and Mai Waifu have the biggest breast size in the game (2.0), while Yui Rio has the smallest size (0.5). Everyone else is in between.

<p style="font-weight:normal;">Realistic Students Tip: Do not go above 2.3 or below 0.2!

Self-Defense:
<p style="font-weight:normal;">Note 1 - inputting an invalid ID will cause the student to become bugged.

Note 2 - giving a student the "Extensive Self-Defense Training" self-defense level will cause the student to be strong as a teacher.

Note 3 - teachers are not affected by self-defense levels.

Male Hairstyles:
​These hairstyles are available for male students only.
 * Note - for some reason, using the color "None" (or an invalid color ID) on Hairstyle 19 gives the student dark skin.
 * Note - leaving the hair section blank will cause a male student to be have the hairstyle that was put in the game last, have a beard, wear sunglasses, have earrings, and when they change shoes their hand texture will become bugged. 

Female Hairstyles:

 * Note - Leaving the hair section blank will cause a female student to have the hairstyle that was put in the game last and the color that was meant for that hairstyle or if it has a custom hair color it will be the color it is meant to have, but have black eyes, and a white friendship bracelet, and when they change their shoes, their outfit will turn completely white
 * These hairstyles are available for female students only.

Teacher Hairstyles
<p style="font-weight:normal;">Note: There is no way to use teachers' hairstyles on female students without modding the game's Assembly-Unity Script file.

Basic Hairstyle Colors:
These are the hairstyle colors that are available for all students.

Note - black may appear charcoal gray on certain hairstyles.

Special Hairstyle Colors:
Note - special hairstyle colors might have additional effects (Example - using Ganguro color on hairstyle 19 gives the student tanned skin and makeup).

None #2- As 19th july build. if you use Kuu Dere's hairstyle, it'll appear very strange and not the colour at all.(like If you put the colour as 'yellow' it'll appear as lime/neon green. <p style="font-weight:normal;">These colors only work with their own corresponding hairstyles. They can not be applied to any other haircut. Using a basic color on hairstyles with a special base color will result in unique color combinations. <p style="font-weight:normal;">As the most recent builds, special colors are equivalent with the "None" hair color.

Eyes
Note - As 28th march build. the player has the ability to change students' eye color by their preference. If you use the ID "Waifu" it will give the student grey eyes. Same happens with student-specific eye colours.

Stockings:
<p style="font-weight:normal;">Note - Stockings are available for female students only. <p style="font-weight:normal;">Note - You cannot have the colored panties and stockings unless you have latest builds.

Male Accessories:
<p style="font-weight:normal;">These accessories are available for male students only.

Female Accessories:
<p style="font-weight:normal;">These accessories are available for female students only.

Teacher Accessories:
<p style="font-weight:normal;">These accessories are available for teachers only. They can be given to female students by modding the game's Assembly-UnityScript file.

Club Accessories:
<p style="font-weight:normal;">These accessories are given to students who are a part of a club.

Daily Schedule Animations
<p style="font-weight:normal;">You can make a student follow a daily schedule by using the following animations. <p style="font-weight:normal;">Note - giving a male student a female student only animation will only make the edited student will spin in place. <p style="font-weight:normal;">Note - In the June 28th build, couples CAN'T cuddle, they only walk while being attached to the bench

Schedule Destinations
These are the locations you can place students in their schedule. I have not added Seat as there is a section explaining that.

Note-If you replace the destination of a student that was supposed to be the one after *Locker*, the student will do the animation they were supposed to do at the place they were meant to at their locker.

Example: "ScheduleDestination":"Spawn_Locker_Seat_Mourn_Podium_Slave_Locker_Exit","ScheduleAction":"Stand_Shoes_Eat_Text_Socialize_Text_Shoes_Stand"},

This is a changed schedule for Mai Waifu that I made, instead of going to eat at her seat, she will eat at her locker. (IDK if it's my computer or a bug, but it does happen so I noted it)

These are all I am currently aware of, so feel free to add more if you find any!

Since The June 15 update, you cannot put hangout and lunchspot on a unknown students

edited students only!

FAQ
Anything not answered? Comment down below and someone will help you as soon as possible! <p style="text-align:center;">

<p style="font-weight:normal;">'''Q: I have modded my game, but all students are girls and they are on fire and have Osana's hairstyle! What do I do?'''

<p style="font-weight:normal;">''A: You've probably made a mistake while editing the JSON file. To fix this problem you need to delete the faulty Students.JSON file and replace it with a backup you made.''

<p style="font-weight:normal;">'''Q: I didn't make a backup! What do I do now?'''

<p style="font-weight:normal;">A: Download the November 19th 2016 Build Students.JSON File here! Make sure to make a backup of the Students.JSON file next time!

<p style="font-weight:normal;">Q: How do you edit students' additional info?

<p style="font-weight:normal;">''A: Visit the Modding: Assembly-UnityScript.dll page. Everything you need to know about editing the additional info can be found there.''

<p style="font-weight:normal;">Q: How do you give students more hair and eye colours?

<p style="font-weight:normal;">A: There are two ways: The first one is to edit the hairstyle's base texture (Visit the Modding page for more info), while the second one is to edit the game's Assembly-UnityScript.dll file (Visit the Modding: Assembly-UnityScript.dll page for more info). <p style="font-weight:normal;">Q: How do you edit the students' facial features/uniforms?

<p style="font-weight:normal;">''A: You cannot edit individual uniforms of students except for Oka, Musume, Kokona, Saki, Mei, Koharu, Yuna, Yui, Midori and Osana. You can edit facial features of any student by editing the base hair of the student in the Texture files via assets, but there is no other way except for what is listed on the Modding page. <p style="font-weight:normal;">'Q: Fun Girl showed up when I launched the game! What went wrong?' <p style="font-weight:normal;">A: You most likely made a punctuation error in the .JSON file while you were editing. The more common errors include deleting a quotation mark, deleting a comma, and/or a punctuation mark changing font. To fix this error, replace the incorrect punctation(s) with the correct ones by copy/pasting the correct punctuation instead of typing it out normally. You can check for incorrect punctuation by using CTRL F (Windows) or CMD F (Mac) and pasting the incorrect punctuation mark in the search bar.''