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:

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

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

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
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 he/she will run out of the school in fear. When they find Ayano killing, they do the same thing.	1
~Teacher's Pet Personality~ When a Teacher's Pet finds a body he/she 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 finds a body they will pull their evil grin, admire it and run out of school. When they see Ayano killing, they will compliment her actions.	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 allerting others to your prescense.	6
~Tsundere Personality~ When a Tsundere 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 Tsundere sees Ayano killing, she will run to Senpai and tell him what you did, if she reached him, you will get an Instant GameOver! [Its called the"Clingy / Damsel" Reaction!] [This is currently not Implemented!]	7
~Strict Personality (Club 100)~ When a Strict Personality type finds a body they will mourn the death and call the police and gaurd the corpse. When they see Ayano killing, they will try to apprehend her.	9
~Friendly but Strict Personality (Club 101)~ Same as Strict (Club 100)	9
?????	Any invalid ID.

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.

Teachers are not affected by self-defense levels.

Self-Defense	ID
"Incapable"	0
"Very Weak"	1
"Weak"	2
"Strong"	3
"Very Strong"	4
"Martial Arts Master"	5
"Extensive Self-Defense Training"	6
"?????"	Any invalid ID.

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.

Hairstyle	ID	Default Color
	0	None
	1	Black
	2	Red
	3	Yellow
	4	Green
	5	Blue
	6	Cyan
	7	Purple
	8	Red
	9	Black
	10	Brown
	11	Orange
	12	Occult2
	13	Occult4
	14	Occult6
	15	None
	16	None
	17	None
	18	None
	19	None
	20	None
	21	None
	22	None
	23	None
	24	None
	25	None
	26	None
	27	White

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.

Hairstyle		ID	Default Color
		0	None
		1	None / White
		2	Red
		3	Yellow
		4	Green
		5	Blue
		6	Cyan
		7	Purple
		8	Pippi
		9	Green
		10	Succubus1
		11	Succubus2
		12	Kuudere
		13	Waifu
		14	Brown
		15	Orange
		16	Occult1
		17	Occult3
		18	Occult5
		19	Ganguro
		20	Osana
		21	RivalChan
		22	Kizana
		23	Kizana2

Teacher Hairstyles

Note: There is no way to use teachers' hairstyles on female students without modding the game's Assembly-Unity Script file.

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

Color	ID
	Pippi
	Succubus1 (gives makeup)
	Succubus2 (gives makeup)
	Kuudere
	Waifu
	Occult1 (gives a shadow)
	Occult2 (gives a shadow)
	Occult3 (gives a shadow)
	Occult4 (gives a shadow)
	Occult5 (gives a shadow)
	Occult6 (gives a shadow)
	Blonde
	Ganguro (gives tan and makeup)
	Osana
	RivalChan (gives a different Head Skin Color!)
	Kizana
	Kizana2

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.           

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 - You cannot have the colored panties and stockings unless you have latest builds.

Image	Stockings	ID
	White Knee-High Socks and White Panties	None / Invalid ID
	Green Knee-High Socks and Green Panties	ShortGreen
	Loose Socks / Leg Warmers (No Special Panties)	Loose
	Red Stockings and Panties	Red
	Yellow Stockings and Panties	Yellow
	Green Stockings and Panties	Green
	Blue Stockings and Panties	Blue
	Cyan Stockings and Panties	Cyan
	Purple Stockings and Panties	Purple
	Pink Polka-Dot Stockings and Pink Panties	Osana
	As March 8, 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, "CustomStockings..." with a number from 1 to 10. If the player doesn't create a custom texture or uses an invalid name, the stockings will be thigh-high and colored grey.	Custom
	Purple Stockings with red roses and green leaves and matching Panties	Kizana
	Black Thigh Highs and White Panties. Same as Yandere- Chan's default black stockings.	Black

Accessories:

Male Accessories:

Accessory	ID	Can Be Given To	Exclusive?
	1	Male Students	No This bandanna can be given to any male student. It is not set by default and is optional.
	2	Male Students	No These glasses can be given to any male student. They are not set by default and are optional.
	3	Male Students	No This earring can be given to any male student. It is not set by default and is optional.
	4	Male Students	No These glasses can be given to any male student. They are not set by default and are optional.

Female Accessories:

Accessory	ID	Can Be Given To	Exclusive?
	1	Female Students	No This medical eyepatch can be given to any female student. It is not set by default and is optional.
	2	Female Students	No These bandages can be given to any female student. They are not set by default and are optional.
	3	Female Students	No This ring can be given to any female student. It is not set by default and is optional. Is set by default on Sakyu Basu as it is an event.
	4	Female Students	No These earrings and scrunchie can be given to any female student. They are not set by default and are optional.
	5	Female Students	No This choker can be given to any female student. It is not set by default and is optional.
	6	Female Students	No This bracelet can be given to any female student. It is not set by default and is optional. Changes its color depending on the student's hair color.
	7	Female Students	No Can be given to any female student They are not set by default and is optional
	8	Female Students	No Can be given to any female student They are not set by default and are optional

Teacher Accessories:

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

Accessory	ID	Can Be Given To	Exclusive?
	1	Teachers	No These glasses can be given to any teacher. They are not set by default and are optional.
	2	Teachers	No These glasses can be given to any teacher. They are not set by default and are optional.
	3	Teachers	No These glasses can be given to any teacher. They are not set by default and are optional.
	4	Teachers	No These glasses can be given to any teacher. They are not set by default and are optional.
	5	Teachers	No These glasses can be given to any teacher. They are not set by default and are optional.
	6	Teachers	No These glasses can be given to any teacher. They are not set by default and are optional.
	7	Teachers	No This whistle can be given to any teacher. It is not set by default and is optional.

Club Accessories:

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

Accessory	ID	Can Be Given To	Exclusive?
	N/A	Male and Female Students	Yes This choker is given to every member of the Occult Club. It is set by default and can not be removed while part of the club.
	N/A	Male and Female Students	Yes This headband is given to every member of the Martial Arts Club. It is set by default and can not be removed while part of the 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 onwards, couples CAN'T cuddle, they only walk while being attached to the bench.

Image	ID	Description	Gender
	"Mourn"	An animation used when a dead loved one passes away. This animation is triggered when you kill one of the Basu sisters, but not the other. This animation is also triggered if a female student is turned into a mindslave. Even if a student hasn't had a loved one pass away, you can still make them mourn as part of their daily schedule.	Female
	"Read"	An animation used by Senpai when he sits on the fountain, the Occult Club members while they are in the Occult Club and Kuu Dere when she sits on the bench. If the student who reads is not Kuu or Senpai, they will read occult books instead of normal books. Even if a student doesn't usually read, you can still make them read as part of their daily schedule.	Male and Female
	"Socialize"	An animation used on Social Butterflies and Teacher's Pets when they talk in the morning and at lunch. Even if a student doesn't usually talk in the group, you can still make them socialize while standing as part of their daily schedule.	Male and Female
	"Sit"	An animation used by every student when they are in their classrooms. Even if a student doesn't usually sit, you can still make them as part of their daily schedule.	Male and Female
	SocialSit"	An animation used by Social Butterflies when they talk in the Cooking Club. Even if a student doesn't usually sit and talk in the group, you can still make them socialize while sitting as part of their daily schedule.	Female
	"Grade"	An animation used by teachers when they grade papers in the Faculty Room. Even if a student isn't a teacher, you can still make them grade papers as part of their daily schedule. It will bug out when used by a student.	Female (Teachers Only)
	"Teach"	An animation used by teachers when they are Teaching Class! Even if a student isn't a teacher, you can still make them teach class as a part of their daily schedule. It wont bug out when used by Students! (Female Only!)	Female (Teachers and Students)
	"Game"	An animation used by Pippi Osu and Ryuto Ippongo when they are playing in the Gaming Club. Even if a student doesn't usually game, you can still make them play video games as part of their daily schedule.	Male and Female
	"Text"	An animation used by Midori Gurin when she is standing on the rooftop. If the student who e-mails isn't Midori, the mobile phone used by Midori will not spawn. Even if a student doesn't usually e-mail, you can still make them as part of their daily schedule. If you want to make her Patrol the Roof while texting, make her Destination:"Patrol" and her Action:"Patrol".	Female
	"Stand"	An animation used by Mai Waifu when she in on the rooftop, Osana Najimi when she stands infront of Senpai, Budo Masuta when he is in the Martial Arts Club and Oka Ruto when she is in the Occult Club. Even if a student doesn't usually stand, you can still make them as part of their daily schedule.	Male and Female
	"Stalk"	An animation used by Kokona Haruka during her lunchtime event, Oka Ruto when she is stalking the Basu sisters in the morning and When Riku is Watching Kokona After School. Even if a student doesn't usually stalk, you can still make them as part of their daily schedule.	Male and Female
	"Eat"	An animation used by Kokona Haruka during her lunchtime event and the Basu sisters and Senpai during lunchtime. If the student isn't Kokona Haruka, you can not poison their food.	Male and Female
	"Shoes"	An animation used by every student when they change their shoes at their lockers. Even if the student has already changed their shoes, you can still make them do it again as part of their schedule.	Male and Female
	"Relax"	An animation that was used by Senpai prior to the July 24th 2016 build when he was sitting at the fountain. Even if a student doesn't usually relax while sitting, you can still make them as part of their daily schedule.	Male
	"Cuddle"	An animation used by Riku Soma and Kokona Haruka during lunchtime if they have been matchmade. Even if two students don't usually cuddle, you can still make them cuddle as part of their daily schedule. [Rikus Cuddle Animation is used by Ryoutoin the Picture and Kokonas Cuddle Animation is used by Pippi in the Picture!]	Male and Female
	"Club"	Club related Animations used by the: "Occult Club and the Martial Arts Club"	Male and Female
	"Clean"	An animation used by all students during Cleaning Time. Even if it's not Cleaning Time, you can still make Students clean.	Male and Female
	"Wait"	An animation used by Musume Ronshaku during Lunchtime, when she is waiting for someone who could give her cigarettes. This animation can be used both by female students. Female students will lean or well, "wait". Male students have a waiting animation but it is not implemented into their "wait" schedule action	Female

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)

Image	Id	Description
	"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.
	"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.
	"Club"	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. If one of the Rainbow Six does not have a club, she will go to her spot that she hangs out.
	"Mourn"	This location will make the student go where the Basu sisters mourn.
	"Slave"	This location will make the student go to where a mind broken slave would.
	"Stalk"(Female)	This will make a student go to where Oka stalks the Basu sisters in the morning.
	"Stalk"(Male)	This will make a student go to where Riku stalks Kokona.
	"Podium"	This will make a student or a Teacher go to their classes' 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 infront 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!)
	"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 and Senpai.
	"Cuddle"(Male)	The student will go where Riku sits with Kokona after getting together. [Rikus Cuddle Spot is used by Ryouto in the Picture!]
	"Cuddle" (female)	The student will go where Kokona sits with Riku after getting together. [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?

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

Start a Discussion Discussions about Modding/JSON Files

• 

  ScheduleTime help

  • 
    Umia Karo
    How do I change the ScheduleTime and number guide pls?  2017-07-19T01:09:01Z
• 

  Modding actions

  • 
    Clemmy-Chan
    So i modded some characters and realized that when i used the mourn action on one of them they would do nothing but stay in the running positi... 2017-07-03T21:56:33Z

See more discussions >