1.

This is a tutorial for script writers and idea-guys who want to see their thoughts turned

into scenes and requests but have no experience coding.

2. If you want to get in contact with a coder, either look in the STG thread, or contact

Maverick at m8a0v2e8r0i8ck@gmail.com

3. I've included [tl;dr]'s in each section to make going back easier (you only really need to

read through this once).

4. The sections included in this tutorial are listed below:

5. 1) Basics - What to Know Before Starting Your Script

6. 1.a) Actors and Poses

7. 1.b) Scenes

8. 1.c) Dialogue

9. 1.d) Script Comments

10. 2) More Advanced Writing - Inserts

11. 2.a) Music and Sound Inserts

12. 2.b) Picture Inserts

13. 2.c) Other Inserts

14. 3) Script Flow - How Do I Make This Readable?

15. 3.a) The All-Important Tab Key

16. 3.b) Menus and Choices

17. 3.c) Whoring Levels

18. 3.d) Other If Statements

19. 4) tl;dr Central

20. 5) Example Script - Taken from Heretic's Mod

21.
22. 1) Basics - What to Know Before Starting Your Script

23.

24. In order coders to do their job properly, they need special input from writers (think of it

like an actual script).

25. There are scenes, actors, dialogue, poses, and script comments.

26. Once you have all of those, you can put them together to write a script.

27.

28.

29. 1.a) Before you start your scene, you need to have the actors and poses ready:

30. What this means is knowing who you want to be in the scene, and having what

you want them to look like.

31. The way to do this is create faces and poses for Hermione in the Generator,

and make sure their filenames fit.

32. For Genie, look in your "game" folder for "mage.png".
33. This shows Genie's default face, while his others are "mage2.png"-

"mage15.png" (We'll get back to this.)

34. [tl;dr] - Make the poses you want in the Generator and give them names.

35.

36. 1.b) So you've got the actors and poses ready! Now we set the scene:

37. For this, you just name the scene you're in.

38. This should be all the way on the left of your screen, so no tabs.

39. You can have a scene named "-Petting" or "-Intro" and for the end "-Wrap up"

(exclude the "").

40. Scene's make it easy to jump around the script and also to know where you

are.

41. Think of them as anchors.

42. [tl;dr] - Name scenes before diving into dialogue. -Scene Name

43.
44. 1.c) Now let's move on to dialogue:

45. Dialogue will be the majority of your script.

46. To start dialogue, we need two things: Actors and Lines.

47. Actors are defined before the lines so we know who's talking.

48. The two biggest actors we have are Genie and Hermione.

49. Genie's default actor name is "m" and Hermione's is "her" (exclude

the "").

50. Remember the different mage faces we covered earlier? Here's where they

become important.

51. Unlike Hermione, Genie has a few facial expressions built into the
game.

52. In order to use something other than the default "mage.png" (tied to

the "m" actor) you have to specify it.

53. If you want "mage9.png" to be the face used for a certain line of

dialogue, start off that line with "g9" instead of "m".

54. For "mage11.png" it's g11, and so on.

55. For custom actors not in the game, you can specify them by giving their name

in quotes before the dialogue.

56. So in general, dialogue will look like this:

57. m "Suck it."

58. her "But I don't want to!"

59. g4 "You're gonna make me angry!"

60. "Custom Character" "Just do what he says!"

61. [tl;dr] - "her" is Hermione, "m" is Genie's default, "g2"-"g15" are Genie's

other faces.

62.

63. 1.d) Script Comments:

64. Lets say you want to have your coder understand something that isn't in the

text.

65. For example you want them to make text bigger or smaller, insert a

picture or pose, play an animation, or a sound/music file.

66. To include your own comments, write them as "#Comment".

67. Be warned, anything in that line after the "#" will be considered a

comment.

68. In other words, don't start a dialogue option with a comment, put it

in the line before or at the end.

69. #Comment
70. m "Bitch" #Comment

71. You can use this to tell your coder things like "#Change her hair color" or

"#Make the screen blink".

72. [tl;dr] - Want to let your coder know something? Start it with a "#".

73.

74. Congrats, you've learned the basics of script writing!

75. Using just the tools above, you can begin to write a basic script!

76. If you want to learn more about important script flow, skip to section 3.

77. If you're ready to learn more advanced parts of script writing, keep reading.

78.
79. 2) More Advanced Writing - Inserts

80. Now that you have the basics down, you might want to cut down on the time you spend writing

comments.

81. Inserts work much the same way as comments, but with more purpose to them.

82. Instead of just adding "#Please include x.mp3 sound file here" every time, use inserts.

83. They save you time, and make coding a lot easier!

84. Here we'll learn about: music and sounds, pictures, and other inserts.

85.

86. 2.a) Music and Sound Inserts:

87. If you want a specific sound played, you have two options:

88. Find one you like in the "game/sounds" folder.

89. Get one yourself and include it in the mod.

90. Specify what sound or song you want to be played by using the "@".
91. If I wanted "game/sounds/clothes.mp3" played, it would look like

"@sounds/clothes.mp3".

92. For music, the same applies, but you can find them in the "game/music"

folder.

93. [tl;dr] - Look in the game folder for music and sounds. Tell me you want

them with "@".

94.

95. 2.b) Picture Inserts:

96. Picture inserts work the same as music/sound inserts, but use <> instead.

97. Use the name of your face/pose in the <>. If you made a face of Hermione

crying, here's what it'd look like:

98. m "What? Are you gonna cry?"

99. her "N-No..." <crying>

100. You can replace <cry> with whatever you'd name your image file for
crying.

101. This is why it's important to shorten the names of your poses, it's

easier to type <c> than <crying>.

102. If you're using an image that's already in a folder, then write like

you did the sounds/music.

103. <my_custom_script/c.png>

104. Note: if you're going to be using images not in the

"13_hermione_main" folder, it should be:

105. <game/name.png>

106. [tl;dr] - Use <> to say you want an image shown.

107.

108. 2.c) Other Inserts:

109. We've already covered "@" for sounds and <> for pictures, others

work much the same way.

110. Non-picture inserts are blocked off by [].

111. These are used when you are more comfortable with your coder and

they know what you do often.

112. Basically, once a coder has seen you ask for something a lot, you

can just use [] to shorten it. Some common ones:

113. Menus, random chances, making her come back at night,

animations, ending the scene, etc.

114. Want to give people a choice, or have a 60% chance of something?

115. [Choice] tells to make a menu (we'll get into menu's later
on).
116. [60%] tells us this'll happen 60% of the time (make sure

chances add up to 100).

117. Remember the scene's we wrote? Here's where they come in handy.

118. If you want to write several scenes and they have the same

ending, use inserts.

119. So you wrote a scene called "-Wrap Up", and want to go

there? Couldn't be easier.

120. [Jump to -Wrap Up]

121. As you and your coder get more comfortable (this'll happen very

quickly) it'll make the process easier and faster.

122. [tl;dr] - Use [] to show you want something done that will require

extra coding.

123.

124. 3) Script Flow - How Do I Make This Readable?

125. You've got the basics down, now we just need to work on your ability to make things

flow well.

126. This is important because scripts can't look like novels (with paragraphs on end).

127. They need to be readable in sections and are almost more of a list of events than a

full story.

128. Some things we'll cover are: the importance of tabbing, menus and choices, and if

statements.

129.

130. 3.a) The All-Important Tab Key:

131. If you've sneaked a peak at the script below, you'll notice how many
tabs there are.

132. This is because it gives a sense of flow to the script (and makes it

easier for coders).

133. It lets readers know what parts rely on other variables.

134. So every time you have your script branch into multiple

possibilities, you need to tab them.

135. The possible variables are laid out in the rest of this section.

136. [tl;dr] - Tabbing is real fuckin necessary

137.

138. 3.b) Menus and Choices:

139. Above we mentioned using menus with other inserts. Here is how to

use them.

140. When you want the player to make a choice or you want a menu to
appear, use either [Menu] or [Choice].
141. Then, the next line should be a tab, showing one of the choices,

followed by another line with the dialogue in it:

142. [Choice]

143. Read the guide

144. g9 "I've got these scripts down."

145. Only read the [tl;dr]'s

146. g4 "I thought I could just read these!"

147. m "The dialogue continues here."

148. If you have a long section after a choice, you can just give them

scene names and write [Jump to -Choice name].

149. This will save you a lot of tabbing and make the flow look a

little nicer, but is not at all necessary.

150. [tl;dr] - Use [Choice] or [Menu] if you want branches, and don't

forget to tab!
151.

152. 3.c) Whoring Levels:

153. Sometimes you want things to branch depending on other variables.

154. One of the most common in Witch Trainer is Hermione's Whoring level.

155. If you want her responses to be different to something, just write

an if statement:

156. m "Take off your skirt"

157. #If whoring is less than 15

158. her "Fuck you!"

159. #If whoring is between 15 and 18

160. her "Well... I guess I can do that."

161. #If whoring >= 19

162. her "I'd love to."

163. m "Dialogue continues here"

164. [tl;dr] - Whoring makes her change her attitude. Don't forget tabs

damnit!

165.

166. 3.d) Other If Statements:

167. In general, all if statements work the same.

168. They branch depending on what if statement is true, then return to

the line of dialogue unless told to end.

169. Other if statements you can use in the game are:

170. How mad she is, what day it is, whether she's done certain
quests, even checking what her hair color is.
171. The biggest thing to remember is that if statements cause a branch.

172. You don't necessarily need 2 branches, but they'll cause something

new to happen.

173. So you can have a new scene pop up if someone meets certain

requirements

174. This is great for just adding in a scene to an already

existing one.

175. "The normal scene"

176. #If she has fancy hair and is wearing a mini-skirt

177. "What happens"

178. [End Scene]

179. "The normal scene continues here."

180. [tl;dr] - If statements can do a lot. But don't forget to tab!

181.
182. 4) tl;dr Central

183. Actors and Poses - Make the poses you want in the Generator and give them

names.

184. Scenes - Name scenes before diving into dialogue. "-Scene Name"

185. Dialogue - "her" is Hermione, "m" is Genie's default, "g2"-"g15" are Genie's

other faces.

186. Script Comments - Want to let your coder know something? Start it with a

"#".

187. Music and Sound Inserts - Look in the game folder for music and

sounds. Tell me you want them with "@".

188. Picture Inserts - Use <> to say you want an image shown.

189. Other Inserts - Use [] to show you want something done that will require

extra coding.

190. The All-Important Tab Key - Tabbing is real fuckin necessary

191. Menus and Choices - Use [Choice] or [Menu] if you want branches, and don't

forget to tab!

192. Whoring Levels - Whoring makes her change her attitude. Don't forget tabs

damnit!

193. Other If Statements - If statements can do a lot. But don't forget to tab!

194.

195. 5) Example Script - Taken from Heretic's Mod

196. Some things to know:

197. This (...) means I've skipped lines, and you're not seeing the full
scene.
198. This ">text" means the narrator is saying something.

199. The faces and pose lists are images Heretic included when he sent me

the script.

200. The difference between faces and poses are: faces are used for

dialogue (bottom right), poses are full body images.

201.

202. Faces List:

203. Ahegao = A

204. Calculating = C

205. Devious = D

206. Embarrassed = E

207. Hesitant = H

208. Naughty = N

209. Pensive = Pe
210. Shocked = S

211. Questioning = Q

212.

213. Pose List:

214. Cumming - p_c

215. Dildo Deep - p_dd

216. Dildo Insert - p_di

217.

218. -Request

219. m "Miss Granger, do you know what a dildo is?"

220. her "I... I'm familiar with the concept." <c>

221. m "Have you used one before?"

222. her "Excuse me?" <q>

223. m "There's no need to be embarrassed, girl, just tell me if you've ever used a dildo

before."

224. her "...yes I have." <e>

225. m "Excellent, well you'll be using one today."

226. [Jump to whichever heart she's on]

227.

228. -HEART 1

229. #If whoring 14 or less

230. [Generic Akabur refusal]

231. #If whoring 15 or more and first time

232. her "You want to watch me masturbate?" <s>
233. her "Er...I have class to get to." <h>

234. (...)

235. #If whoring 15 or more and not first time

236. We have lot's to do today

237. (...)

238. [Choice]

239. That's enough.

240. m "Alright, you can go. Fifty points to Gryffindor."

241. her "Uh, sir... Could you help me?" <n>

242. ">Genie waves his hand. The dildo erupts out of Hermione, who begins

spasming in ecstasy again." <p_c> @sounds/magic2.mp3

243. m "Now say thank you."

244. her "Th...thaan...thank you...siiir." <a>

245. m "Hurry along Miss Granger, I haven't got all day."

246. ">Hermione slowly rises off the floor and lurches out of the room on

shaky legs."

247. [End Scene]

248. #If whoring less than 16 increase whoring by 1

249. That gives me an idea...

250. #If whoring 16 or more

251. m "No, you leave that where it is."

252. (...)

253. [End Scene]

254. [Make her come back at night]

255.

256. -Night Time

257. [Random Chance (60% A; 30% B; 10% C)]

258.

259. -A

260. m "Hello, Miss Granger."

261. her "..." <p>

262. (...)

263. [+50 points to Gryffindor]

264. [Jump to -Wrap Up]

265.

266. -B

267. m "How do you feel?"

268. (...)
269. [-30 points from Gryffindor]

270. [Anger + 5]

271. [End Scene]

272.

273. -C

274. m "You don't look too great."

275. (...)

276. [+50 points to Gryffindor and +30 points to Slytherin]

277. [Jump to -Wrap Up]

278.

279. -Wrap Up

280. m "Well I'm glad you had fun."

281. her "Trust me, I did..."

282. (...)
283. [End Scene]