Modding/JSON Files

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. Or 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!


 * Tip From Yulla Le~ Fab: Instead of reading the Destinations and Actions side by side, imagine them horizontally. I personally find it easier to read and connect them together.

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



Editing Key Info
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.

Naming a student "Random" will spawn a random generated Student, just like the High Population mode, the game automatically choses a:

Name, Personality, Hair, Skin Color and Hair / Eye Color.

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

Schedule Time
Note: Only 10 events are allowed while JSON-Modding! Meaning you can edit 6 events of your choice, leaving 4 for entering and leaving school

Schedule Time is divided by underscores, "_" If one is missing, the whole game will bug out

.05 or 5% is equivalent to 3 minutes in Yandere Simulator i:e 50% = 30 mins or half an hour.

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 102 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 behavior.

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

Note 5 - choosing the School Nurse Occupation gives the student the school nurse model and behavior.

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 - a female student WILL NOT spawn if the hair ID is 20.
 * These hairstyles are available for female students only.

Teacher Hairstyles
Note: There is no way to use teachers' hairstyles on female students without modding the game's Assembly-Unity Script file or downloading Pose Mod        DOWNLOAD HERE 

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

Note -  Black may appear charcoal gray on certain hairstyles.
 * This section isn't currently up to date. For it to be up to date, hair colors Council1, 2, 3, and 4 must be added.

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). 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.

As of 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.''
 * The Student Council members eyes are currently not listed. [Please remove this note once all Student Council members' eye colors are added.]

Stockings:
Note -  Stockings are available for female students only.

Note -  You cannot have the colored panties and stockings unless you have latest builds. 2

Accessories:

 * Note: If you change it to "None" the student spawns with Musume's hair Kizana's Necklace and the friendship bracelet, along with white eyes.

Teacher Accessories:
These accessories are available for teachers only. They can be given to female students by modding the game's Assembly-UnityScript file.

Club Accessories:
These accessories are given to students who are a part of a club.

Daily Schedule Animations
You can make a student follow a daily schedule by using the following animations.

Note - giving a male student a female student only animation will only make the edited student will spin in place and vice versa.

Note - June 28th build and on-wards, 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)

{| class="article-table" !Image !Id !Description
 * Student_Spawn_Points.png
 * "Spawn"
 * This is where a student spawns each day. It's different for every student, so to know where they will stand I would suggest checking where they spawn first.
 * Students_Leave_School.png
 * "Exit"
 * This location will make a student leave the school.
 * "Exit"
 * This location will make a student leave the school.

If you go to class the student will spawn at their seat.


 * "Locker"
 * This location makes a student go to their locker. like Spawn, each one is different so check the ID's locker first.

 This only works for the Rainbow Six, the Occult Club (the six meant to be in the club), and the Martial Arts Club (again, those meant to be in the club). If you give them a different club, they will still go to their intended spot.This destination will make the student go to their respective clubs.
 * "Club"

If one of the Rainbow Six does not have a club, she will go to her spot that she hangs out. a mind broken slave would. This will make a student or a Teacher go to their classes' podium.
 * MournDes.png
 * "Mourn"
 * This location will make the student go where the Basu sisters mourn.
 * SlaveDes.png
 * "Slave"
 * This location will make the student go to where
 * "Slave"
 * This location will make the student go to where
 * OkaStalk.png
 * "Stalk"(Female)
 * This will make a student go to where Oka stalks the Basu sisters in the morning.
 * MaleStalk.png
 * "Stalk"(Male)
 * This will make a student go to where Riku stalks Kokona.
 * Teacher_in_class.png
 * "Podium"
 * Teacher_in_class.png
 * "Podium"
 * "Podium"



"Patrol" This makes a student walk around the first, second, or third floor depending on their ID.

If Patrol is not in the animation slot, then students will stay near the occult club corridor.

Patrol Slots:
Student ID: 21- 40 (Floor 1)

Student ID: 41- 60 (Floor 2)

Student ID: 61 - 80 (Floor 3)

Student ID: 81 - 100 (Floor 4 / Roof)

Exceptions:
 

Student ID: 1 (Senpai) (Senpai will Patrol around the Outside of the School)

 Student ID: 13 (Riku Soma)

(Riku will Patrol the 1. Floor, while Stalking at the Stalk [Male] spot sometimes. Used in the Afternoon by Riku!)

 

Student ID: 14 (Pippi Osu) (Stands in front of Osanas Phone Call Location, to demonstrate a Stalking Concept from Yandere Devs "Lets Examine Persona" Video", But if you want her to Stalk, Please use "Stalk" as a Action, Since Patrol will make her Buggy, but you can also use a Different one.)



 Student ID: 15 (Ryuto Ippongo)

(Stands near the Bathrooms where Osana gets her Phone Call!)

  Student ID: 16 (Midori Gurin)

(Midori Patrols the Roof While Texting!)

 Student ID: 86 (Kuroko Kamenaga) 

(Kuroko patrols the different faculty-based rooms, Nurse Office etc.)

 Student ID: 87(Shiromi Torayoshi ) 

(Shiromi patrols the outside area, like Senpai)

 Student ID:88 (Akane Toriyasu) 

(Akane patrols the different club rooms)

 Student ID: 89 (Aoi Ryugoku) 

(Aoi patrols all the floors, including roof.)

The student will go where Riku sits with Kokona after getting together.
 * "Hangout"
 * This destination depends on the student's ID. It will only work for the rainbow twelve, Basu sisters, Kuu Dere, Mai Waifu, Pippi, Ryuto, Midori, Osana, Kizana, Musume, Senpai and the Student council. Any ID past 34 (except the Student council) will not have a Hangout spot.
 * Finally.jpg
 * "Cuddle"(Male)
 * "Cuddle"(Male)

[Rikus Cuddle Spot  is used by Ryouto in the Picture!] The student will go where Kokona sits with Riku after getting together.
 * Finally.jpg
 * "Cuddle" (female)
 * "Cuddle" (female)

[Kokonas Cuddle Spot  is used by Pippi  in the Picture! ]
 * "LunchSpot"
 * This destination depends on students ID. Students will go where that student spends their lunchtime.
 * "Clean"
 * Students will Clean, depending on their ID.
 * }

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! 

'''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?'''

''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.''

'''Q: I didn't make a backup! What do I do now?'''

https://www.mediafire.com/file/583u8be34yfiyaz/Students%20-%20BACKUP%20COPY.json  here! Make sure to make a backup of the Students.JSON file next time! Q: How do you edit students' additional info?

''A: Visit the Modding: Assembly-UnityScript.dll page. Everything you need to know about editing the additional info can be found there.''

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 punctuation(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.''