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.)This image shows Ty-dere's backup files for Yandere Simulator. These backups are from the September 29th Build.
- 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 and you will spawn as Pink Yandere Chan. If this happens, check for extra/missing colons, quotation marks, or periods, and make sure all info is valid.
Right, without further ado, let's 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
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 chooses 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 ie: 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.)
Gender | ID |
---|---|
Female | 0 |
Male | 1 |
Class
Inputting an invalid ID will cause the student to become bugged.
Class | ID |
---|---|
1 - 1 (Reina Nana's Class) | 11 |
1 - 2 (Natsuki Anna's Class) | 12 |
2 - 1 (Rino Fuka's Class) | 21 |
2 - 2 (Shiori Risa's Class) | 22 |
3 - 1 (Karin Hana's Class) | 31 |
3 - 2 (Kaho Kanon's Class) | 32 |
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.
Note 6 - choosing the Student Council Club will make the student buggy.
Note 7 - choosing the No Club (Bullies) gives the student tanned skin, this only works for IDs 81-85. A student who is in the bullies club and whose ID is not 81-85 will have white textures and be glitchy.
Club | ID |
---|---|
No Club | 0 |
Cooking Club | 1 |
Drama Club | 2 |
Occult Club | 3 |
Art Club | 4 |
Light Music Club | 5 |
Martial Arts Club | 6 |
Photography Club | 7 |
Science Club | 8 |
Sports Club | 9 |
Gardening Club | 10 |
Gaming Club | 11 |
Student Council | 13 |
No Club (Bullies) | 14 |
Teacher (Faculty) | 100 |
Gym Teacher (Faculty) | 101 |
Nurse (Faculty) |
102 |
????? | Any invalid ID. |
Personality
Putting an invalid ID will make the student bug.
Persona | ID | |
---|---|---|
~Loner Personality~ When a Loner finds a body they will run out of the school in fear. When they find Ayano killing, they do the same thing. Afterward, they will warn other students about Ayano being a murderer and lowering her reputation by 10 every day they are alive. | 1 | |
~Teacher's Pet Personality~ When a Teacher's Pet finds a body they will run to their classroom teacher and report it. When they find Ayano killing, they do the same thing. | 2 | |
~Heroic Personality~ When a Heroic Student finds a body they will repeat the Teacher Pet's actions. When they find Ayano killing, they will try and apprehend her. | 3 | |
~Coward Personality~ When a Cowardly Student finds a body they will repeat the Loner's actions. When they see Ayano killing, they will plead for mercy and run out of the school. | 4 | |
~Evil Personality~ When an Evil Student sees Yandere-Chan committing murder, they will grin and run out of the school. When they find a corpse, they will be amused by it, then they'll run out of the school. They won't call the police. | 5 | |
~Social Butterfly Personality~ When a Social Butterfly finds a body they will scream and run to their designated spot and call the police or hide. When they see Ayano killing, they will scream and call the police. If they see you approaching they will scream alerting others to your presence. | 6 | |
~Lovestruck Personality~ When a Lovestruck finds a body, she will run to Senpai, tell him what she saw and they both run out of the School and call the Police. If a Lovestruck sees Ayano killing, she will run to Senpai and tell him what you did, if she reaches him, you will get an Instant Gameover. | 7 | |
~Dangerous Personality~
Council members pepper spray you and immediately take you down if you get too close to them 3 or more times, or if they see you kill someone. If they discover a corpse, they will call a teacher and stand there to guard with them as well. If a teacher has already been called, they will stand near the body to guard it. | 8 | |
~Strict Personality (Club 100)~
When a Strict Personality type finds a body they will mourn the death and call the police and guard the corpse. When they see Ayano killing, they will try to apprehend her. They will also expel you if you misbehave! A Game Over will occur! | 9 | |
~Friendly but Strict Personality (Club 101)~
Same as Strict (Club 100) | 9 | |
~Phone Addict Personality~
When a Phone Addict student witnesses murder, they will snap a picture and text the police, resulting in a instant game over. If they discover a corpse, they will snap a picture and text the police, triggering the police timer. | 10 | |
~Fragile Personality~
When a Fragile student witnesses murder, they will plead for mercy like Cowards. If they discover a corpse, they will run out of the school and call the police. A Fragile student can be broken into committing Murder-Suicide. Only females with ID 32 can be broken. | 11 | |
~Spiteful Personality~
When a Spiteful student witnesses murder or discovers a corpse, they will run out of school and call the police. If they are being bullied, and they witness the death of a bully, they will run out of school and won't call the police. If they witness the death of any student with low reputation, they will also grin, run away from the school, and won't call the police either. | 12 | |
~Sleuth Personality (Not functional!)~
This personality is not functional yet. A student with this persona will be incredibly buggy. (In the future, when many murders or disappearances happen in school, or when a student's loved one disappears, they will start investigating around the school.) | 13 | |
~Vengeful Personality (Not functional!)~
This personality is not functional yet. A student with this persona will be incredibly buggy. (In the future, when a student witnesses Yan-Chan murdering someone, they will start stalking her in hopes of catching her committing murder again.) | 14 | |
~Protective (Partially functional)~
This personality is partially functional right now. It may be a lefover of upcoming content. A student with this persona will be very buggy. If a student with this persona witnesses murder, they will apprehend you without any struggle like a teacher would. If you attempt to kill them, they will sense it and instantly apprehend you. | 15 |
Crushes
Inputting an invalid ID will cause the student's info screen to go blank.
Crush | ID |
---|---|
No Crush | 0 |
The Name Corresponding to the ID | 1 - 98, 100 |
"?????" | 99, any invalid ID. |
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.
The '99' Self-Defense is Stun Gun only for the headmaster, for normal students, its '???'
Self-Defense | ID |
---|---|
"Incapable" | 0 |
"Very Weak" | 1 |
"Weak" | 2 |
"Strong" | 3 |
"Very Strong" | 4 |
"Martial Arts Master" | 5 |
"Extensive Self-Defense Training" | 6 |
"Armed with Pepper-Spray" | 7 |
"Invincible" | 8 |
"???" | 99 |
Editing Hairstyles
Male Hairstyles
- 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.
These hairstyles are available for male students only.
Female Hairstyles
- Note - The hairstyle "21" is Yandere chan's hairstyle (but in a darkness Color)
- 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
Hairstyle | ID | Default Color |
---|---|---|
![]() | 1 | Brown |
![]() | 2 | Brown |
![]() | 3 | Brown |
![]() | 4 | Brown |
![]() | 5 | Brown |
![]() | 6 | Brown |
![]() | 7 | Blonde |
![]() | 8 | White |
Basic Hairstyle Colors
These are the hairstyle colors that are available for all students.
Note - Black may appear charcoal gray on certain hairstyles.
Example #1 | Example #2 | ID |
---|---|---|
![]() | ![]() | Black |
![]() | ![]() | Red |
![]() | ![]() | Yellow |
![]() | ![]() | Green |
![]() | ![]() | Blue |
![]() | ![]() | Cyan |
![]() | ![]() | Purple |
![]() | ![]() | Orange |
![]() | ![]() | Brown |
![]() | ![]() | White |
![]() | ![]() | None / Invalid ID |
Special Hairstyle Colors:
Note - Special hairstyle colors might have additional effects (Example - using Ganguro1 color on hairstyle 26 gives the student tanned head and makeup). These colors only work with their own corresponding hairstyles. They cannot 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 colors will give the student grey eyes instead.
Male Eye Colors | Female Eye Colors | ID |
---|---|---|
![]() | ![]() | Black |
![]() | ![]() | Red |
![]() | ![]() | Yellow |
![]() | ![]() | Green |
![]() | ![]() | Blue |
![]() | ![]() | Cyan |
![]() | ![]() | Purple |
![]() | ![]() | Orange |
![]() | ![]() | Brown |
![]() | ![]() | White |
![]() | ![]() | None / Invalid ID |
Stockings:
Note - Stockings are available for female students only.
Note - As of March 8th, 2017, the player is able to add custom stockings to a female by creating a texture inside of the streaming assets folder. In the July 28, 2017 build, you can add ten custom stockings. They must be named, "CustomStockingsX" with a number from 1 to 10.
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.
Male Accessories:
Female Accessories:
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 walk 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.
Note - Giving the "Wait" animation to a student and doing Musume's task. That student will smoke just like Musume.
Note - Giving a Student anywhere other than their destination "Seat" the action "Sit" will cause the Student to walk in place.
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.
Additional Info
As of July 18th, 2017, the additional information of all students are now editable through the Students.json file.
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."
Do not put quotation marks in the additional info section, for example: They call him "the snake" because of his constant...
This will make the JSON invalid and you'll spawn as pink Yandere Chan. Instead, use apostrophes: They call him 'the snake' because of his constant...
FAQ
Anything not answered? Comment down below and someone will help you as soon as possible!
Q: I didn't make a backup! What do I do now?
http://www.mediafire.com/file/0xl83ccv3mong6x/Students+-+March+15+2018.json here! Make sure to make a backup of the Students.JSON file next time!
Q: How do you give students more hair and eye colors?
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).
Q: How do you edit the students' facial features/uniforms?
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.
Q: Fun Girl showed up when I launched the game! What went wrong?
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.
Q: Can I ask someone to make me a portrait/custom stockings?
A: You can! However, it is no longer allowed to ask for those in this page. You can visit Useful Tools, at the end is a list of users you can ask to make whatever you need.