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:
Displayed on student info screen and other screens that display the student's name. Anything that is typed will become the student's name.

Naming a student "Unknown" or "Reserved" will cause them to not spawn when the game starts. Changing their names away from this will make them spawn again.

If a male student is named "Delinquent" they will have an angry facial expression, and carry around a pipe identical to the one that Dandy Pompadour has.

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

Gender:
If you put another number besides 0 and 1 in this section, the game is going to be started in an empty school and the JSON alert will spawn on Yandere-chan.

Since male and female models have a different set of animations, giving a student certain animations in their schedule may cause them to bug out. (Example: male students don't have an animation for texting, and will glitch if you add texting as part of their schedule.)

Class:
Inputting an invalid ID will cause the student to become bugged.

Seat:
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.

Inputting an invalid ID will cause the student, as well as all of the teachers, to disappear.

Clubs:
''Note 1 - inputting an ID higher than 101 will cause the student to become taller and act as a teacher. (Female students only)''

Note 2 - choosing the Occult Club gives the student a frowning face.

Note 3 - choosing the Teacher Occupation gives the student the teacher model and behaviour.

Note 4 - choosing the Gym Teacher Occupation gives the student the gym teacher model, animations and behaviour.

Personality:
Putting an invalid ID will make the student bug.

Crushes:
Inputting an invalid ID will cause the student's info screen to go blank.

Breast Size:
Only available for female students.

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. Realistic Students Tip: Do not go above 2.3 or below 0.2!

Self-Defense:
Inputting an invalid ID will cause the student to become bugged.

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

Teachers are not affected by self-defense levels.

Male Hairstyles:
​These hairstyles are available for male students only.
 * Note - Using the color "None" (or an invalid color ID) on Hairstyle 19 gives the student dark skin, most likely because the ID is the same as Musume Ronshaku's.
 * Note - Using the color "None" (or an invalid color ID) on Hairstyle 23 will give the student orange cat eyes.
 * Note - Using the color "None" (or an invalid color ID) on Hairstyle 24 will give the student dark purple eyes.
 * 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. 
 * Note - Using a valid hair color on Hairstyle 27 will result in only the back of the hair changing.
 * Note - Using the color "None" (or an invalid color ID) on hairstyle 27 will give the student a scar and blue eyes.

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
 * Note - The game will not spawn females with Hairstyle 20, as of now.
 * 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).<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 of the March 28th build, the player has the ability to change students' eye colors by their preference. Using student-specific eye colours will give the student grey eyes instead.''

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:

 * 1) <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 and vice versa. <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!

Additional Info
As of July 18th, 2017, the additional information of all students are now editable through the Students.json file.

Any kind of information can be typed in the additional info section.

To make a sentence begin on a new line, type " \n \n " (including spaces) in front of the sentence that you want to begin on a new line.

Leaving the additional info blank will make the info in-game say, "No additional information is available at this time."

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:  ☀http://www.mediafire.com/file/583u8be34yfiyaz/Students+-+BACKUP+COPY.json  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.''