MonsterGirlQuest Wiki

This wiki will close in two weeks (Wednesday November 24). Fandom is removing wikis on topics that contain large amounts of sex, nudity and/or fetish material. Even if the wiki itself is kept "clean", we are still unable to host it.

The two week's pause is so you can look for a new host and copy your content there.

I'm sorry for the bad news -- Sannse

READ MORE

MonsterGirlQuest Wiki
Luka vs the Colosseum.png

My intentions for this page are to explain through example every aspect of a side story and how they are used. I will include documentation along the way so every command will explain what it's doing (at least the first time) and how it is used. Please do not edit this page, I'll get to it on a fairly regular basis.

I started writing in here right away without actually planning it out... caused a few problems as I started going through it in my head... So, I'm currently writing the actual Side Story - on the side - and will update here as I get it working properly... Ideally, I'll have a downloadable version available before it's completed here...

Battles and Battle Structure is a little more complicated than I'd originally thought, at least to map everything 'perfectly'. So this is going to take a while... I'm currently working on a battle section which can be found at Side Stories - Battle Commands and will update from there. That said, the current story outline is going to be changed somewhat to make it fit a little better...

I will update it here shortly so as to make it work; however it's going to be a bit of time before the story is completed. I'm currently debating how I'm going to add the separate files (since it's done with restart,path\subpath to control all the fight situations, really holding them all on one page is too much; so using separate pages has so far been the only option I've found that really works. Though, doing it that way will create a whole bunch of very redundant pages. I don't feel the wiki needs those... Any suggestions would be wonderful; thanks. :)

... battle writing takes a long time... ... I was hoping it'd be a bit faster than this, though... I guess I'm still trying to figure out every possible action from within a battle... will speed up when I finish documenting it I guess... does look promising though... :)

... Alright, so far Slime Girl is undefeated in my tests... I've not tested a whole lot, but I set Luka to level 50, level 99, every time he hits her it does 0 damage... Anyway, will keep looking, clearly I'm doing something wrong. Either that or I really have to use flail wildly... :-?

Description

27/04/2014

Alright, so I've been working on a monsterpedia file, as well as a side story editor. Some of you may wonder, why bother with the side story editor? Since side stories are so limited in what you can do with them. Other's may wonder, why work on a monsterpedia? there's one in the game..? Well, I'll answer both of those questions here... Though, they are unrelated to the purpose of this page. So you can read them if you'd like, or you can proceed below them to the actual content of this page.

Side Stories / Side Story Editor

When I first came to the Monster Girl Quest Wiki, I had no idea about the limitations of Side Stories, I felt that creating a Side Story editor would be awesome! Then looking at the previously documented commands that you can use in a Side Story, I realized just how limited they were. My first reaction was - why bother making a side story editor? Then I thought, well people still make side stories, I can make it easier to do that, fairly easily since they're so limited... Then I thought, well... there are commands in some side stories that I've never heard of, and that I didn't understand how they worked. So I started doing research into the Monster Laboritory and discovered a bunch of new commands, figured out how they worked, then documented them in the 'making a side story' section of this page. Now I realize that a Side Story, though still inherently limited, can be quite elaborate, so an editor is something that could be a great tool for side story creators to both assist them in Side Story developement, as well as showing them just how far they can take their stories.

Monsterpedia

Creating a monsterpedia isn't so much about seeing all the graphics in the game, it's more about knowing what's available. The monsterpedia is meant for side story developers as well as people making a repatch, to show all the different graphics in the game, their filenames, and who they relate to specifically. Originally I had intended to create a monsterpedia that was limited to each individual monster entry, though early on I realized that there were some issues with doing that. Not all graphics are actually referenced in battle, and beyond that, extracting specific graphic to battle information is a very lengthy process. Anyway, not going to happen. I refuse. Instead, I've created a monster specific graphic list. This is not monster / fight specific, but monster specific. For instance, Granberia has multiple entries, though each entry references all of Granberia's graphics. This is the first test that I did with splitting them up on a fight specific basis. Granberia has 2 images that aren't referenced in battle, they are instead referenced later on in the Monster Lord's castle, during a non-battle scene. Not very useful to have undocumented images. Anyway, that's why we need a monsterpedia, so that people creating can have an actual image list that's already been broken down in a character specific way.

Putting it all together What I've decided to do in the interm, is create a Side Story, without an editor. The purpose of this side story is to show how everything that you can use in a side story is actually used. Hopefully I'll find a good reason to use the four remaining undocumented commands in side story developement somewhere in here... The creation of this Side Story will not be done privately however, instead I'm going to create it here, on the site. I will document the use of every command (at least the first time I use the command) and explain what they're doing as well as how they work. Hence, Putting it all together...

The Story

I've decided to create a Side Story that takes place in the coliseum. In it, Luka will battle every creature within the game. Winning a battle will award Luka a bonus, losing a battle will allow him to retry, though he will not recieve a bonus for the battle's completion. As a side story developer, you can go through to the individual sections (which will be linked somewhere on here) for each monster to see their specific image list. That's the plan... We'll see how it goes...

pre-story notes ... all variable use is being remapped, I'm having issues with the battle development as, well - it's just slightly more problematic than I'd assumed it would be. I've decided that viewing the 'extra' moves with points earned isn't exactly a valid option, as tracking this over a number of monsters becomes problematic with limited variable use.

as such, all images and moves will be available to the user after they battle set character... at least, that's the plan... battle control is a little more problematic than I'd originally thought, the battles will not be exactly as they were in the original game, which is fine because they all take place in the Coliseum anyway, so they're not supposed to be exactly the same... doesn't matter, I'm getting to it... the first battle I'll be posting (001_SlimeGirl) will contain a fairly basic battle tutorial, as the battle's become more advanced, well... yeah... so will the tutorials I guess...

[Setting]

[setting] -> title=[1]
[setting]
title="Luka vs The Colosseum"
notes:[2]

[intro]

bg[3]
0 = "bg,bg043,10,1500 "
name[4]
1 = "name,Leprichaun "
No Command[5]
2 = "Well, Luka... I'm sending you to the Colosseum as an example... "
3 = "To show writers how they can create their own stories. "
4 = "as well as a reference specific monster girls from all over this world. "
5 = "name,Luka "
6 = "Reference monster girls? "
7 = "For what? What do you mean? "
8 = "name,Leprichaun "
9 = "... Alright, so you're not going to remember this anymore... but this... "
10 = "... this is a game, Luka... and the writer's need to access images... "
11 = "or their stories don't work... "
12 = "name,Luka "
13 = "A game? what do you mean a game? You're not playing with me! "
flash[6]
14 = "flash,250,500 "
15 = "name,Leprichaun "
16 = "Anyway, it's time for you to fight Luka, I've set your level back to 1. "
17 = "You will get stronger after every fight, so don't wory... "
18 = "Ontop of that, you will be awarded points for every new attack that hits you. "
19 = "You can use those points later to view different attacks, if you wish. "
20 = "name,Luka "
21 = "..? wha..? what happened..? The colosseum? How'd we get here..? "
22 = "name,Leprichaun "
23 = "what? You don't remember..? "
24 = "We left the castle days ago on our great journey to the colosseum... some BIG plan you had, it was wonderful, blah blah blah! and you don't even remember it!? "
25 = "That's horrible! I could be back at the castle right now ... working... with that lovely little imp girl... but noooo... i had to come here with you! "
26 = "you don't even remember why we're here!? "
27 = "name,Luka "
28 = "uh... well... I'm sure it must be something important... If I was going to take you away from your time with the 'imp girl' ... pervert... "
29 = "name,Leprichaun "
30 = "Luka! I'm kidding, sheesh... you really don't remember, do you? The imp girl and I have never really gotten along... "
31 = "name,Luka "
32 = "no, I really don't remember... "
33 = "name,Leprichaun "
34 = "Well, we'ere here to help train the various gods across the relm in scripting their own stories... "
35 = "so they can control you, as well as others, and initiate battles against every monster girl in the world! "
36 = "name,Luka "
37 = "..? what? wait, why would I want to do that? "
38 = "What gods? what are you talking about!? What about the Goddess, Illias? isn't she the only 'god'? "
39 = "What's going on here!? Why are we..."
40 = "flash,250,500"
41 = "name,Leprichaun "
42 = "Well Luka, we've finally arrived at the colosseum... It's been a long trip, but we're here... "
43 = "name,Luka "
44 = "The Colosseum..? what are we doing here? "
45 = "name,Leprichaun "
46 = "Oh Luka, you're a funny one... we're here because you wanted to be here, and I agreed to come with you... "
47 = "name,Luka "
48 = "uh... alright... ... I guess we should just head in then... "
var_ld[7]
49 = "var_ld,v0,1"
goto[8]
50 = "goto,story"
end[9]
51 = "end"

[story]

var_cpa[10]
0 = "var_cpa,v0,=,0,0"
var_jump[11]
1 = "var_jump,intro"
2 = "name,Luka "
3 = "... alright, what's next..? "
Select[12]
4 = "select,Lets Fight! ,doBattle,Consession Stand,doPics,The Announcer,doAnnouncer,Go Home,doExit"
5 = "end"

[group1]

variable notes for group1: [13]

1 = "name,Announcer "
2 = "var_cpa,v6,=,0,0"
3 = "var_jump,group1_FirstBattle"
 ; if we're still here, the var_jump didn't fire... so we progress with the story...
4 = "Alright Luka, lets see where you're at in group 1... "

var_out: [14]

5 = "var_out,You've had ,v6, fights "
6 = "var_out, and,v2, victories...@"
7 = "Go on out, your opponent should be waiting for you..."
8 = "var_cpa,v2,1,0"
9 = "var_jump,003_SlugGirl
10 = "..."
11 = "end"

[group1_FirstBattle]

1 = name,Announcer "
2 = "Well Luka, It's your first battle. You're up against the Slime Girl, "
3 = "don't forget your sword... "

sprites with sp command: [15]

4 = "sp,2,angersword,0,0,10,1000 "

deleting a sprite made with the sp command: [16]

5 = "sp_del,2,10,1000 "
6 = "Luka... it's time to fight! "
7 = "goto,001_SlimeGirl"
8 = "..."
9 = "end"

[group2]

variable notes for group2: [17]

1 = "name,Leprichaun "
2 = "this hasn't been written yet... lets go back to the story... "
select: [18]
3 = "goto,story"
4 = "..."
5 = "end"

[group3]

variable notes for group3: [19]

1 = "name,Leprichaun "
2 = "this hasn't been written yet... lets go back to the story... "
3 = "goto,story"
4 = "..."
5 = "end"

[group4]

variable notes for group4: [20]
1 = "name,Leprichaun "
2 = "this hasn't been written yet... lets go back to the story... "
3 = "goto,story"
4 = "..."
5 = "end"

[001_SlimeGirl]

notes 'n' stuff: [21]

1 = "bg,bg084,10,1500 "
2 = "name,Announcer "
3 = "Welcome to the coliseum folks, have we got a show planned out for you today! "
4 = "Monster's from aroudn the world, most of whome have never participated here, "
5 = "have gathered to fight one man! You all know him, it's Luka! "
6 = "name, "
7 = "the audience stands and applods "
8 = "name,Announcer "
9 = "First up, Luka is going to face a slime girl! "
10 = "And while her level is extremely low, we've set Luka's to match! "
11 = "Welcome to the colesium's main event folks, I hope you're ready for a long show... "

restart: [22]

12 = "restart,LukaVsAll\001_SlimeGirl
13 = "..."
14 = "end"
not a bad idea to list out the backgrounds you intend to use, just for your own reference...
delete them from your story when you're going to 'publish' it though...
;background information
;bg084 - the Coliseum
;bg043 - stairs, going to use it as the entrance to the arena

NOTES

  1. [setting]
    the setting section of your story holds only one important bit of information... the title... nothing else is loaded from here...
    because nothing else is loaded from here, it's a great place to put notes about your side story for people to read when looking through it...
    title = "Luka vs The Colosseum"
    this is the title of your story (well my story)... it will appear in Monster Girl Quest under the Extras menu after selecting 'Spin-Off Stories'.
    Please note that you'll need to add your story folder to the list.ini file in the mod folder.
  2. This side story is being developed / was developed to assist others in learning how to create Side Stories of their own. As I write this story, I will document every new command as I come to them. It is an ongoing tutorial, feel free to ask a question if you have one.
  3. 0 = "bg,bg043,10,1500 "
    the bg command allows you to change the current background image... it's made up of 4 parts...
    • bg - the command
    • bg043 - the background I'm selecting
      • bg043 is a stock background that is included in the game, hence no extension...
      • if you were to use a custom background image, you'd have to include it's extension and path (bg.png if it's in your side story folder, any deeper and you need to include the folder paths...)
    • 10 - the transition you're using
    • 1500 - transition duration in ms (1000ms = 1 second)
    more information
  4. 1 = "name,Leprichaun "
    The namme command is very straight forward. It's made out of 2 parts, though the second is optional.
    • name - the command
    • Leprichaun - the name
    Important things to remember about the name command is a trailing space after the name...
    Other than that, it's important to know that sometimes you must use the name command without a name or comma, will explain that when I get to that point in the story.
  5. When there's no command, what you're writing is text / speach. It is said by whoever is currently referenced as the speaker with the name command... good stuffs...
  6. 14 = "flash,250,500"
    the flash command is made up of 3 parts, and causes the screen to 'flash' from it's present state to solid white then back again...
    • flash - the command
    • 250 - flash in duration in ms (time it takes to reach full brightness)
    • 500 - flash out duration in ms (time it takes to return to the normal display)
    more information
  7. 49 = "var_ld,v0,1"
    var_ld is a 3 part command
    • var_ld - the command
    • v0 - the variable to load data into (v0 through v9 are available in side stories)
    • 1 - the value we're loading into v0...
    more information
  8. 50 = "goto,story"
    goto is a very straight forward 2 part command... goto, where...
    • goto - the command
    • story - the target [story]
    the specified target must exist and must be spelled exactly the same way...
  9. 51 = "end"
    the end command ends the story... pretty straight forward...
    it's important to end every section of your story with an end command though, because if you make it to the end of a section without jumping somewhere else, it's gonna crash...
  10. 0 = "var_cpa,v0,=,0,0"
    the var_cpa command has 5 parts
    • var_cpa - the command
    • v0 - the variable we're testing
    • = - what comparison we're doing
    • 0 - we're checking if it's equal to 0
    • 0 - sets a flag if the comparison is true
    more information
  11. 1 = "var_jump,intro"
    var_jump has 2 parts and is very similar to a goto statement... but it's a conditional goto statement, advanced usage (sort of) of var_jump will be shown later in the story.
    • var_jump - the command
    • intro - the target [intro]
    more information
  12. 4 = "select,Let's Fight! ,doBattle,Consession Stand,doPics,The Announcer,doAnnouncer,Go Home,doExit"
    The select command can have up to 9 parts... though I'm only going to explain the first 3...
    • select - the command
    • Let's Fight! - caption of the first button
    • doBattle - target [doBattle]
    part 2 and 3 of this repeat for additional buttons, you can have up to 4...
    this is a choice based goto statement, the user selects which button to press, thus which destination to take. also pretty cool...
    because it's like a goto statement, the same rules apply to it that apply to a goto statement... the target MUST exist...
    more information
  13. : v6 holds how many fights Luka has had in this section
    v2 deals with how many victories he's had here...
  14. : var_out,$string,variable,$string2
    var_out allows you to display the contents of a variable. You can put
    text before the variable, and text after it. You must have a minimum of
    the comma though to indicate if you didn't put text in. var_out does not
    end the string of text, it will not make the user click after it's displayed...
    keep that in mind when using it... putting a @ at the end will cause a pause.
    here I'm using 2 var_out's in a row, which will display both variables without
    user intervention... fun stuff...
  15. : sp, layer, $file, x,y,transition,duration
    this one's a little more complicated.
    layer this can be set between 0 and 9, higher layers overlap lower ones...
    $file is the filename, like bg it can be your own or one from the game
    x is the x offset, can be positive or negative - offset is from the center
    of the screen, and positions from the center of the image.
    y is the y offset, can be positive or negative - offset is from the center
    of the screen, and positions from the center of the image.
    transitions are the same as they are in bg
    duration is the same as in bg as well, done in ms - 1000 = 1 second.
  16. : sp_del,layer,transition,duration
    this deletes a sprite from the screen...
    it's exactly the same as SP, but less complex...
  17. : v7 holds how many fights Luka has had in this section
    v3 deals with how many victories he's had here...
  18. goto,target
    goto is just what it sounds like, you're going there. there are no choices...
    the target i'm using is [story], it must be something that exists within your
    currently active story.ini file.
  19. : notes - v8 holds how many fights Luka has had in this section
    v4 deals with how many victories he's had here...
  20. : v9 holds how many fights Luka has had in this section
    ; v5 deals with how many victories he's had here...
  21. : ; in concept, this works - I haven't written or documented the battle yet however...
    ; keep checking back, I'll get to it when I can... however, I've spent enough time
    ; at it for the day...
  22. : restart,$path
    the restart command loads a side story...
    using it from within a side story allows you to do all sorts of fun things,
    like have more than one battle in your story for instance...
    when you list the path to restart, the base folder is the mod folder, so
    you must include your side story folder as well. In this case, LukaVsAll...
    in the LukaVsAll folder / directory, there is a sub folder / directory called
    001_SlimeGirl, in which all custom sounds / graphics relating to that side story
    are contained as well. Also, it has it's own story.ini file...
    you'll see it branched off later when I add it...