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 separate 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. They're third-party programs 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.
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.)
| Gender | ID |
|---|---|
| Female | 0 |
| Male | 1 |
Class
Inputting an invalid ID will cause the student to become bugged.
Note - Inputting 0 as the class will make that student tell Kyoshi about corpses if they are a teachers pet.
| Class | ID |
|---|---|
| 1 - 1 (Reina Nana's Class) | 11 |
| 1 - 2 (Natsuki Anna's Class) | 12 |
| 2 - 1 (Rino Fuka's and Ayano 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 the 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.
Here is a seating chart of the students as of the February 20th, 2019 Build.
Although Osana, the Mysterious Obstacle, and the Rivals cannot be added to the game, by viewing the JSON and YandereDev's videos, their seat location can be confirmed. Unless he decides to re-locate them in the future.
 |
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.
Note 8 - choosing Cooking, Drama, Art, Light Music, Science, Sports, Gardening, Gaming or Delinquent clubs will make the student buggy.
| 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 |
| Delinquent | 12 |
| Student Council | 13 |
| No Club (Bullies) | 14 |
| Teacher (Faculty) | 100 |
| Gym Teacher (Faculty) | 101 |
|
Nurse (Faculty) |
102 |
| ????? | Any invalid ID. |
Persona
NOTE - Putting an invalid ID will make the student bug.
| Persona | ID | |
|---|---|---|
|
~Loner Persona~ 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 when they are alive. | 1 | |
|
~Teacher's Pet Persona~ When a Teacher's Pet finds a body they will run to the faculty room and tell their classroom teacher and report it. When they find Ayano killing, they do the same thing If Ayano hides the body before the teacher comes to the body the teacher will say "So, was this just a prank? I don't think it's very funny. Don't waste my time like this again." | 2 | |
|
~Heroic Persona~ When a Heroic Student finds a body they will repeat the Teacher Pet's actions. When they find Ayano killing, they will try to apprehend her. | 3 | |
|
~Coward Persona~ 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 Persona~ 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 Persona~ 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 Persona~ When a Student with the Lovestruck Persona 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 Game Over. | 7 | |
| ~Dangerous Persona~
Council members pepper spray you and immediately take you down if you get too close 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 Persona (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, a Game Over will occur!. They will also send you to the Guidance Counselor if you misbehave! | 9 | |
| ~Friendly but Strict Persona (Club 101)~
Same as Strict (Club 100) | 9 | |
| ~Phone Addict Persona~
When a Phone Addict student witnesses murder, they will snap a picture and text the police, resulting in an instant game over. If they discover a corpse, they will snap a picture and text the police, triggering the police timer. | 10 | |
| ~Fragile Persona~
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. | 11 | |
| ~Spiteful Persona~
When a Spiteful student witnesses murder or finds 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 grin, run away from the school, and won't call the police. | 12 | |
|
~Sleuth Persona~ When atmosphere is high, Sleuths will react to murder or a corpse by going to a safe space and calling the police (like the Social Butterflies). If atmosphere drops to 80% or below, they will patrol all around the school checking on every student, if they witness murder or discover a corpse, they will take a picture and run away (like the Phone Addicts). If they witness Ayano commiting murder, but Ayano manages to hide all evidence, the next day the witness(es) along with the Photography Club (only original PC IDs) will start following you and will run away if you get close. | 13 | |
| ~Vengeful Persona~ (Not Functional)
This persona is not implemented yet. (In the future, if a student witnesses you murder a loved one or a family member, and you get away with it, they will start following you until they witness you commit murder again. They will snap a picture if they catch you doing so.) | 14 | |
| ~Protective Persona~ (Partially Functional)
This persona is partially functional right now. If a female student with this personality and "Invincible" strength witnesses murder or discovers a corpse, they will go to apprehend you without any kind of struggle. If you try to attack or sneak kill a Protective student, they will prevent the attack and apprehend you without any struggle. | 15 | |
| ~Violent Persona~
The delinquents' personality. It only works on IDs 76 to 80 (The delinquents' IDs). If you use it on any other student, they will stand in the same spot forever and have spasms. If you get too close to them, they'll push you away. If they push you too many times, or you get close with a weapon, a fighting minigame will begin. If they witness your murdering someone, they'll attack you and will take you out much more easily. | 16 |
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 |
| "Peak Physical Strength" | 5 |
| "Extensive Self-Defense Training" | 6 |
| "Armed with Pepper-Spray" | 7 |
| "Armed" | 8 |
| "Invincible" | 9 |
| "???" | 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 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. This also applies to female students.
These hairstyles are available for male students only.
Female Hairstyles
- Note - a female student WILL NOT spawn if the hair ID is 20, Unless you delete the ”NobodyScript” and the "OtherScript" in the Assembly-CSharp.dll.
- 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.
If you add a color on a special hairstyle like , for exemple, Kokoro's hairstyle, colors might be kind of mixed.
| 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 to 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 |
Eye-Types
- As of the December 5th, 2018 Build, you can now change a student's eye-type through the Json.
NOTE - Eye-types do not work on Faculty Members.
 | Default |
 | Male |
 | Round |
 | Serious |
 | Sad |
 | Gentle |
 | Mean |
 | Smug |
 | Thin |
Stockings
Note - Stockings are available for female students only.
Note - As of March 8, 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 28th, 2017 build, you can add ten custom stockings. They must be named, "CustomX" with a number from 1 to 10.
Accessories
- Note: If you change it to "None" the student spawns with Kuu Dere’s hair, Kizana's necklace, the friendship bracelet, the bullies wrist scrunches, 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 28 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 an Unknown student.
Additional Info
As of July 18, 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...
- Helän Sehora Says:
Actually you can use double qoutes! Just put a \ to the left of the double qupute & it will work!
They call him /"the snake/"
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/z88zbuubzhb2rut/Students26April2018.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, the Bullies, The rainbows 6, Midori, Horuda or 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.
Disclaimer: You can ask for help in the comments below, but PLEASE, don't copy the ENTIRE JSON. This clogs up the comments and makes it tedious to scroll around.
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 on this page. You can visit Useful Tools, at the end is a list of users you can ask to make whatever you need.
.png){kind=link}
.png){kind=link}
