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. Attempting to spawn Osana by changing her name from "Reserved" to something else will cause Fun Girl to appear instead. The slots left for Raibaru and the remaining rivals will not spawn any students although they already have names entered.
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, Gender, Personality, Strength (if the randomized student has the Heroic persona), Hair, Skin Color (if male) and Hair / Eye Color. If a student named "Random" has Patrol in their schedule destination and action, they will patrol random areas in hallways on certain floors and on the rooftop.
Real Name
Displayed on student info screen under the student's nickname. Anything that is typed will become the student's real name.
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, all the students and faculty members will disappear 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.)
If you attempt to change one of the Sports Club's Gender, they will end up having a bugged out gym uniform when they get changed in the male locker room.
| 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 Teacher's 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. Giving more than one student the same ID may cause bugs when the students attempt to sit.
Here is a seating chart of the students as of the September 18th, 2019 Build.
Although your Rivals and Osana cannot be added to the game currently, by viewing the JSON and YandereDev's videos, their seat location can be confirmed that way unless they are changed 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 (for the wrong students) will make the student buggy. The Student Council's unique dialogue and animations are loaded based on their IDs, and the game will fail to load any for other students as there are none associated.
Note 7 - choosing the No Club (Bullies) (for the wrong students) 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 (Buggy), Drama (White Eyes), Art (Accessory + White Eyes + Painter's Smock), Light Music (Buggy White Uniform), Science (White Eyes + Science Uniform), Sports (Buggy, Fly in the air), Gardening (White eyes and has a white flower pot), or Gaming Club (white eyes), or the Delinquents (for the wrong students) will make the student buggy. The game will attempt to load a unique accessory (for clubs, such as the Science Club's roses)/Flowers (for Gardening Club) exclusive to the student's ID, but they will not have one. The Occult, Photography and Martial Arts Clubs' accessories are not ID-based and those clubs can be used on any student.
| 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 |
| Delinquents | 12 |
| Student Council | 13 |
| No Club (Bullies) | 14 |
| Teacher (Faculty) | 100 |
| Gym Teacher (Faculty) | 101 |
|
Nurse (Faculty) |
102 |
| ????? | Any invalid ID. |
Persona
Note 1 - Putting an invalid ID will make the student bug.
Note 2 - As of the June 18, 2019 Build, giving a student Persona 15 will trigger Fun Girl instead of starting the game.
| Persona | ID | |
|---|---|---|
|
~Loner Persona~ When a Loner finds a body they will run out of the school in fear and call the police. When they find Ayano killing, they do the same thing. | 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 without calling the police. They do not count as a witness for the police or lower Ayano's reputation if left alive. | 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 under any circumstance. | 5 | |
|
~Social Butterfly Persona~ When a Social Butterfly finds a body they will scream and run to their crowded spot and call the police or hide. When they see Ayano killing, they will do the same thing. 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~
The Student Council member's persona, they will pepper spray you and immediately take you down if you get too close 3 or more times, approach them with a weapon 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. They will send Ayano to the Guidance Counselor if she is acting suspicious. | 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. They will send Ayano to the Guidance Counselor if she is acting suspicious. | 9 | |
| ~Friendly but Strict Persona (Club 101)~
Same as Strict (Club 100) | 9 | |
| ~Phone Addict Persona~
When a Phone Addict finds a corpse they will snap a photo and send it to the police, triggering the police timer. If Ayano can be seen as the murderer in the picture, it will cause an instant Game Over instead. | 10 | |
| ~Fragile Persona~
A Fragile student reacts the same way as a Coward to murder and corpses. They 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 witness the death of a student with low reputation or a bully while they are being bullied, they will grin, run out of the school and won't call the police. They do not count as a witness if they do not like the murdered student. | 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 (IDs 56-60) will start following you and will run away if you get close. If they witness another Photography Club member (IDs 56-60) being murdered, they will apprehend Ayano instead. ID 56 will act like a Heroic student instead of a Social Butterfly when witnessing any murder at high atmosphere. | 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 Ayano gets too close to them, they'll push her away. If they push her too many times, or she get close with a weapon, a fighting mini-game will begin. If she wins, they will be unable to attack her unless they witness her killing someone. If she loses, she will be beaten up and it will be easier for them to cause a Game Over if they witness her killing someone. If they witness Ayano murdering someone, they will run toward her and initiate the fighting mini-game, but will not stop if she is beaten up and causes a Game Over. If she wins the mini-game, they will continue to attack her until they are killed. | 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!
| Student(s) | Size |
|---|---|
| Yui Rio | 0.5 |
| Most Female Students | 1 |
| Musume Ronshaku | 1.5 |
| Kokona Haruka and Mai Waifu | 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 1 - 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 2 - Using the color "None" (or an invalid color ID) on Hairstyle 23 will give the student orange cat eyes.
- Note 3 - Using the color "None" (or an invalid color ID) on Hairstyle 24 will give the student dark purple eyes.
- Note 4 - 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.
- If you attempt to use Hairstyle 1-6 and 15-26 will make the hair colour white, since it needs one of the colours in-game for it to have a color.
These hairstyles are available for male students only.
Female Hairstyles
- Note 1 - 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.
- Note 2 - As of the June 18, 2019 Build, giving a student Hairstyle 21 will trigger Fun Girl instead of starting the game.
- These hairstyles are available for female students only.
- Hairstyle 6 and 5 will stay the same color regardless of if the script says a different color or if the player has killed someone.
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 | Teacher |
 | 2 | Teacher |
 | 3 | Teacher |
 | 4 | Teacher |
 | 5 | Teacher |
 | 6 | Teacher |
 | 7 | Coach |
 | 8 | Nurse |
Basic Hairstyle Colors
These are the hairstyle colors that are available for all students.
Note 1 - Black may appear charcoal gray on certain hairstyles.
Note 2 - If you add a color on a hairstyle with unique colors (For Example: Supuna Churu's hair), 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 on the wrong student will give the student grey eyes instead.
Note - As of the May 2019 Builds, attempting to use any of the colours will work but when you murder someone, their hair would turn back into the colour that was there before.
| 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 male students (Male students should all have the "Male" eye-type.)
 | Default |
 | Male |
 | Round |
 | Serious |
 | Sad |
 | Gentle |
 | Smug |
 | Thin |
 | Rival1 |
 | MO |
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, and 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 will cause them to use the smoking animation 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 1 - If you replace the destination of a student that was supposed to be the one after "Locker", the student will do the animation at their locker instead of the designated area.
Example 1: "ScheduleDestination":"Spawn_Locker_Seat_Mourn_Podium_Slave_Locker_Exit","ScheduleAction":"Stand_Stand_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)
Example 2: "ScheduleDestination":"Spawn_Locker_Slave_Seat_Peek_Seat_Podium_Locker_Exit","ScheduleAction":"Stand_Stand_Text_Seat_Peek_Seat_Socialize_Shoes_Stand"},
Note 2 - Since the June 15 update, you cannot put "Hangout" and "LunchSpot" on a student without one (or an Unknown student before all of them were implemented). Attempting to do so will cause bugs.
These are all I am currently aware of, so feel free to add more if you find any!
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, as they are used to separate parameters in JSON files. 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 quotes! Just put a \ to the left of the double quote & 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.
Q: What if I want to customize a female student’s panties?
A: You can make your own stockings (CustomStockings) and then in students.json, student's stockings name write : CustomX (X- number. ex.Custom1).If you saved your stockings as ex.CustomStockings3 in Student's stockings name write : Custom3. REMEMBER TO SAVE CUSTOMSTOCKINGS AS PNG FILE. (CustomStockings Containts panties). You can also edit stockings by using SharedAssets.
Q: What if I want to customize a uniform, gym uniform or swimsuit?
A: You can go on the StreamingAssets then open the "How to make custom uniform", then it should prompt you to do it on Notepad. Follow the on-screen instructions of how to edit it, then you can open the Gym Uniform or a uniform/stockings to edit it, it will originally choose Paint, but you can change it to Photo Shop instead, after that, before you save it, i recommend making a backup copy of the uniform/stockings that doesn't have edits, after that, you can save yours on the original uniform, then rename it to (For Example: CustomGym) to show it up in the game.
☀https://yandere-simulator-fanon.fandom.com/wiki/Modding#Sharedassets.assets_Modding (here's everything that you'll need. follow the instructions.)
.png){kind=link}
.png){kind=link}
