Difference between revisions of "Game Bible"

From Tuxepedia
Jump to navigation Jump to search
 
(2 intermediate revisions by 2 users not shown)
Line 10: Line 10:
* Random encounter rates
* Random encounter rates
* Money gained and lost from trainers after battles won or lost
* Money gained and lost from trainers after battles won or lost
* How conditions are marked in the GUI


= The Project =
= The Project =
Line 46: Line 45:


== The Forums ==
== The Forums ==
[https://github.com/Tuxemon/Tuxemon/discussions GitHub Discussions]


== IRC ==
[https://forum.tuxemon.org/ Old forum] - some of the posts are recoverable through the Wayback Machine.  
[https://tuxemon.org/irc.html IRC]


== Github ==
== Github ==
Line 64: Line 63:


A Python script (stored in the git repository) can download the images for specified tuxemon on the wiki, allowing for easy importing into the game.   
A Python script (stored in the git repository) can download the images for specified tuxemon on the wiki, allowing for easy importing into the game.   
=== Content that is yet to be incorporated ===
* [https://forum.tuxemon.org/thread.php?id=75 josepharaoh99's overland sprites]
* [https://forum.tuxemon.org/thread.php?id=76 Logos and draft logos]
* [https://forum.tuxemon.org/thread.php?id=68 PastTheFuture's tiles]
* [https://forum.tuxemon.org/thread.php?id=38 Kelvin's tiles and music] and [https://forum.tuxemon.org/thread.php?id=54 overland sprites]
* [https://drive.google.com/file/d/0B6IZeVOq4LaaNjc4cFZqc2xEV2M/view The images in the design doc]
* [https://github.com/Tuxemon/Tuxemon/wiki Some information on the Github wiki]


=== Related projects ===
=== Related projects ===
Line 87: Line 78:
Posting any contributions (explicitly described as such) to this game on this web forum is a tacit acceptance of the fact that you are placing them under the Creative Commons Attribution-ShareAlike 4.0 International or any later version. You maintain your own full rights to the contributions, and may continue to do whatever you, the owner, wish to do with them, but you have given us the right to use them under the limitations of the CC BY-SA 4.0. You can read the details of the Creative Commons license here:
Posting any contributions (explicitly described as such) to this game on this web forum is a tacit acceptance of the fact that you are placing them under the Creative Commons Attribution-ShareAlike 4.0 International or any later version. You maintain your own full rights to the contributions, and may continue to do whatever you, the owner, wish to do with them, but you have given us the right to use them under the limitations of the CC BY-SA 4.0. You can read the details of the Creative Commons license here:
https://creativecommons.org/licenses/by-sa/4.0/
https://creativecommons.org/licenses/by-sa/4.0/
[https://forum.tuxemon.org/thread.php?id=83 Original post]


== Maps ==
== Maps ==
* [[Creating Maps|Tutorial: Creating your own maps]]
* [[Creating Maps|Tutorial: Creating your own maps]]
* [[Creating Map Events|Event Handling]]
* [[Creating Map Events|Event Handling]]
* [https://forum.tuxemon.org/thread.php?id=201 SPRINT 3! Getting the maps, encounters and NPCs done]


== Tuxemon ==
== Tuxemon ==
Line 112: Line 100:
== Maps ==
== Maps ==


Tuxemon supports maps created with [http://www.mapeditor.org/ Tiled]. There are [https://forum.tuxemon.org/thread.php?id=201&p=1 many major and minor maps yet to be created].
Tuxemon supports maps created with [http://www.mapeditor.org/ Tiled].  
 
=== Tilesets ===
=== Tilesets ===


Line 252: Line 239:
Cheat codes are a way to make the game easier (eg without spending too much time in leveling up and by focusing on the plot).
Cheat codes are a way to make the game easier (eg without spending too much time in leveling up and by focusing on the plot).


If you name the player "ApexPlayer", then you'll start the game with all the starting monsters at level 100 (max evolution).
If you name the player '''ApexPlayer''', then you'll start the game with all the starting monsters at level 100 (max evolution).


= Soundtrack and Sound Effects =
= Soundtrack and Sound Effects =
Line 315: Line 302:
=== Damage Multipliers ===
=== Damage Multipliers ===
When a technique is used on a monster, the type(s) of the technique is compared to the type(s) of the monster. In some cases, this results in the technique's damage being multiplied or divided.  
When a technique is used on a monster, the type(s) of the technique is compared to the type(s) of the monster. In some cases, this results in the technique's damage being multiplied or divided.  
'''Technique''' 
* Fire techniques do half damage to Earth monsters and double damage to Metal monsters 
* Earth techniques do half damage to Metal monsters and double damage to Water monsters 
* Metal techniques do half damage to Water monsters and double damage to Wood monsters 
* Water techniques do half damage to Wood monsters and double damage to Fire monsters 
* Wood techniques do half damage to Fire monsters and double damage to Earth monsters 
'''Monster''' 
* Fire monsters take half damage from Wood techniques and double damage from Water techniques
* Earth monsters take half damage from Fire techniques and double damage from Wood techniques
* Metal monsters take half damage from Earth techniques and double damage from Fire techniques
* Water monsters take half damage from Metal techniques and double damage from Earth techniques
* Wood monsters take half damage from Water techniques and double damage from Metal techniques
=== Type Identifications ===
* '''Fire:''' Includes creatures associated with energy, like electricity and heat, dragons and other legendary beings, and poison. 
* '''Water:''' Includes creatures associated with the sea, lakes and swamps, ice and snow, the weather, and fish and amphibians.
* '''Wood:''' Includes creatures associated with plants, lichen and fungi, forests, the natural environment, the wind and flying, and the wilderness.
* '''Earth:''' Includes creatures associated with the ground and underground, dirt and soil, mountains and rocks, caves, and ancient and buried things.
* '''Metal:''' Includes creatures associated with steel, darkness, mechanical and robotic things, psychic powers and other unnatural things, humankind, and the undead.


== Sprites ==
== Sprites ==
Line 363: Line 329:
Some [[:Category:Fusion|manual fusions]] have been created as proofs of concept.  
Some [[:Category:Fusion|manual fusions]] have been created as proofs of concept.  


== Pseudo-Tuxemon ==
== Threats ==


Although not yet fully developed, there is an idea that some entities may be able to be battled, but will not be tuxemon. For example, your tuxemon may fight a martial artist, a killer robot, or a gunslinger.  
Although not yet fully developed, there is an idea that some entities may be able to be battled, but will not be tuxemon. For example, your tuxemon may fight a martial artist, a killer robot, or a gunslinger.  


These would not be able to be caught (so they don't need back or face sprites), but would otherwise behave like tuxemon.
These would not be able to be caught (so they don't need back or face sprites), but would otherwise behave like tuxemon.
== Plot-Specific Tuxemon ==
Most of the over a hundred tuxemon that we design could be placed in the game in any situation or area. However, there are a few that have a specific role in the plot:
=== Old Starters ===
''Main article: [[:Category:Starting Tuxemon]]
These are the starters the Protagonist can choose from in [[Paper Town]]:
* [[Heronquak]]
* [[Lambert]]
* [[Nut]]
* [[Agnite]]
* [[Rockitten]]
=== New Starters ===
''Main article: [[:Category:Starting Tuxemon]]
These are the exclusives that your Rivals can choose from.
* [[Dollfin]]
* [[Magmaturtle]]
* [[Memnomnom]]
* [[Budaye]]
* [[Grintot]]
=== Exchange Student Starters ===
''Main article: [[:Category:Starting Tuxemon]]
These are the starters that the exchange students in [[Flower City]] offer to trade with you. They don't morph, suggesting that some unique process is required to unlock their morphs.
* [[Foxfire]]
* [[Conileaf]]
* [[Hampotamos]]
=== Gifts ===
* [[Vivipere]] (from [[Flower City]])
* [[Sampsage]] or [[Sampsack]] (for completing the [[Dojo of the Five Elements]])
* [[Chloragon]] (hatches from [[Ancient Egg]] given in [[Candy Town]])
=== Fossils ===
''Main article: [[:Category:Fossil]]
Both found in [[Tunnel B]] as fossils.
* [[Rhincus]]
* [[Shammer]]
=== Uniques ===
''Main article: [[:Category:Unique]]
* [[Volcoli]] ([[Dryad's Grove]])
* [[Drokoro]] ([[Dragon's Cave]])
== Other Tuxemon ==
Apart from the plot-specific tuxemon, it would be good to keep a mix of:
* Tuxemon that are unique to particular routes or other places
* Tuxemon that are found in several routes or other places
* Tuxemon that can only be gotten by trading
* Tuxemon that can only be gotten by swimming or fishing


= Battle =
= Battle =
Line 438: Line 346:
== Dual Duels ==
== Dual Duels ==
A couple of places in the story anticipate that double battles will exist. On [[Route 5]] the [[Little Heirs]] and the [[Dynamic Dynasts]] represent two trainers each, and at [[Omnichannel HQ]] it's expected that you'll team up with your [[Rivals]] to fight a series of double battles. [[:Category:Duo]] is the category for sprites for double battles.  
A couple of places in the story anticipate that double battles will exist. On [[Route 5]] the [[Little Heirs]] and the [[Dynamic Dynasts]] represent two trainers each, and at [[Omnichannel HQ]] it's expected that you'll team up with your [[Rivals]] to fight a series of double battles. [[:Category:Duo]] is the category for sprites for double battles.  
This is not a necessary feature if it is not able to be implemented.


= People =
= People =
Line 447: Line 353:
Regardless, all people have a [[profession]], which determines their overland sprite and (if they are trainers) their battle sprite. They also all have dialogue. Trainers will also have a team, which is the tuxemon that they carry with them that they will battle you with.  
Regardless, all people have a [[profession]], which determines their overland sprite and (if they are trainers) their battle sprite. They also all have dialogue. Trainers will also have a team, which is the tuxemon that they carry with them that they will battle you with.  


There are currently sprites for dozens of professions, and while we always appreciate more, there are [https://forum.tuxemon.org/thread.php?id=179 only three more that are essential for the main story].  
There are currently sprites for dozens of professions.


== Templates ==
== Templates ==
Line 477: Line 383:


* The game is nominally 256 x 144 pixels, but is displayed at five times that size. Text is displayed at a higher resolution (so "five pixel high" text is actually 25 pixels high, with all the detail and nuance that that suggests).  
* The game is nominally 256 x 144 pixels, but is displayed at five times that size. Text is displayed at a higher resolution (so "five pixel high" text is actually 25 pixels high, with all the detail and nuance that that suggests).  
* The current released version uses Python >= 3.9.
* [https://forum.tuxemon.org/thread.php?id=13 Installation instructions]
* [https://forum.tuxemon.org/thread.php?id=219 FAQ thread]


== Features ==
== Features ==


* [https://forum.tuxemon.org/thread.php?id=131 In-game language translations]
* In-game language translations
* [https://forum.tuxemon.org/thread.php?id=47 Rumble support]
* Allows up to three save files (for that retro GameBoy experience).
* Allows up to three save files (for that retro GameBoy experience).



Latest revision as of 09:51, 15 February 2024

The game bible is intended to be an authoritative, up-to-date record of the community's agreed plan for the project. It is not the documentation for the actual game itself.

Auto-generated documentation of the Tuxemon codebase can be found here: http://docs.tuxemon.org/

To Add[edit | edit source]

  • Leveling up
  • Buying and selling items (distribution, price, etc.)
  • Random encounter rates
  • Money gained and lost from trainers after battles won or lost

The Project[edit | edit source]

To create an open source monster catching, collecting and battling game in Python, to run on Windows, Mac, Linux and Android devices.

The flow on from this is that:

  • The Tuxemon game engine can be used for other games
  • The Tuxemon game engine can be used for sequels ("Tuxemon the Game" becomes "Tuxemon Episode 1", and we can go Beyond Episode 1)
  • The Tuxemon monsters, characters, places, techniques and so on can be used in other media
  • The Tuxemon community is supportive and fun

Tuxemon was begun by ShadowApex in 2012.

Objectives[edit | edit source]

Tuxemon is ...

Legal[edit | edit source]

Tuxemon should not breach anyone's copyright, trade marks or patents. It must not use other people's work, including adaptations of other people's work, unless those works in the public domain or are under free and open copyright licences like Creative Commons Attribution, Creative Commons Attribution-ShareAlike, and CC0.

Versatile[edit | edit source]

Tuxemon should be easy to modify, so people can create their own creatures, items, techniques, stories, music, etc., and insert them into the game. Within the main story, The Spyder in the Cathedral, there is even the Hunting Grounds that make inserting some of these things easier.

Original[edit | edit source]

Tuxemon draws inspiration from a number of monster battling games, but it is not a direct clone of any of them.

Democratic[edit | edit source]

As a project by the community, for the community, Tuxemon's creation should be directed by the volunteers who have contributed to its development. This means both respecting volunteers who disagree with a proposal, and respecting the volunteers who made the proposal.

The Forums[edit | edit source]

GitHub Discussions

Old forum - some of the posts are recoverable through the Wayback Machine.

Github[edit | edit source]

Github page

Create a branch for every set of changes you make to the project (do not just let them build up into one big pull request).

The Wiki[edit | edit source]

The wiki should be the main repository of information, assets, and so on for the Tuxemon project.

A previous version of this wiki is archived at [[1]].

Tools[edit | edit source]

A Python script (stored in the git repository) can download the images for specified tuxemon on the wiki, allowing for easy importing into the game.

Related projects[edit | edit source]

There are other open source projects working on monster catching games. Many of Catch Challenger's assets have been added to the Tuxemon wiki.

See Related Projects for more.

See also Similar Games for proprietary examples of monster catching games, with reviews and reflections from Tuxemon project participants.

Contributing[edit | edit source]

See How to Contribute

Licensing[edit | edit source]

Posting any contributions (explicitly described as such) to this game on this web forum is a tacit acceptance of the fact that you are placing them under the Creative Commons Attribution-ShareAlike 4.0 International or any later version. You maintain your own full rights to the contributions, and may continue to do whatever you, the owner, wish to do with them, but you have given us the right to use them under the limitations of the CC BY-SA 4.0. You can read the details of the Creative Commons license here: https://creativecommons.org/licenses/by-sa/4.0/

Maps[edit | edit source]

Tuxemon[edit | edit source]

Story[edit | edit source]

Tuxemon has a main story, but it should be easy to create new stories and add them (see "versatile", above).

Region[edit | edit source]

There are many ideas for The Region that is the location of the first Tuxemon game.

The region is currently unnamed.

Maps[edit | edit source]

Tuxemon supports maps created with Tiled.

Tilesets[edit | edit source]

Tiles are 16x16 pixels. You can use any of the many tilesets that we have on the wiki, or design your own.

Map design[edit | edit source]

There should be one sign for each map transition. These are in the form:

dialogue 1: "Name of Location: Slogan for Location" dialogue 2: <- Name of Location --- Name of Location ->

Use ^ for North and v for South.

If long grass appears on the map, you need to specify the encounters for that map in a JSON file. Likewise if water is reachable on the map. Surfing on and fishing in water always carries the chance of an encounter, even if it's in a settlement.

Map implementation in Tiled[edit | edit source]

All objects (events and collisions) should be rectangles (drawn with the rectangle tool) or straight lines (drawn with just two points), not polylines, polygons or other shapes.

Animations are supported.

Types of location[edit | edit source]

All locations can have water.

Land routes[edit | edit source]

  • 20x40 or 40x40 squares
  • Long grass with encounters
  • Trainer battles

Sea routes[edit | edit source]

  • 20x40 squares
  • Trainer battles
  • Encounters while surfing
  • Any land could have long grass

Dungeons[edit | edit source]

  • 20x40 squares or 40x40 squares
  • Trainer battles
  • Encounters while walking anywhere

Settlements[edit | edit source]

  • 20x40 squares or 40x40 squares
  • No trainer battles
  • No long grass

Interiors[edit | edit source]

  • Any size
  • Should have a back wall of two or three squares in height
  • Side walls optional (style varies)
  • Trainer battles okay, if it's a type of building that makes sense for them

Buildings[edit | edit source]

Each settlement should have some or all of the following:

Scoop Store[edit | edit source]

This is a general store.

Cathedral Centre[edit | edit source]

This is a government-run building funded by your taxes, but it is increasingly becoming corporatised. For example, to receive healing you have to sit through an advertisement - unless you're a Gold Pass holder. Gold Passes cost $1 more than the maximum wallet capacity in the game, and entitle you to all the services that used to be free.

Cathedral ads

At higher difficulties, the Centres would charge for healing instead of playing ads.

Other services:

All are restricted to Gold Pass holders, so ordinary citizens end up providing these services in their own homes.

Pillar HQ[edit | edit source]

The pillars are the five major corporations in this region. Their HQs are where most of their staff are based.

Cafe[edit | edit source]

These are informal meeting places, where you can re-battle trainers you've already fought, get new apps for your phone, get taught new techniques, trade tuxemon and receive free (and ad-free) healing.

Main Story[edit | edit source]

New spyder map.png

The main story is The Spyder in the Cathedral, set in the Fondent region. It follows a familiar model of the protagonist traveling from town to town, catching and battling creatures. However, the protagonist ends up discovering cruelty and corruption at the very heart of the region, and defeating their villainous scheme.

The main story is set in an unnamed country. There were plans to make the country Ancient Egypt-themed, as can be seen in some of the concept art. However, we have heavily used existing art assets, and therefore there is not currently an observable Egypt theme.

The game opens with the Introduction, which ends with the Protagonist being escorted to their home in Paper Town.

These are the country's locations, roughly in order as the protagonist heads through the game:

The towns are loosely named after wedding anniversary gifts.

Travel[edit | edit source]

Your Mom gives you a Surfboard that can go over water. This is required to progress the game once you reach Candy Town; it's also required to access Volcoli in Dryad's Grove, Dragon's Cave in Sea Route C and the wild encounters in Route 6.

When you reach Timber Town, the Riverboat Stations open up for places you've visited so far. When you visit Candy Town, it becomes available too. The complete list is:

Cheat Codes[edit | edit source]

Cheat codes are a way to make the game easier (eg without spending too much time in leveling up and by focusing on the plot).

If you name the player ApexPlayer, then you'll start the game with all the starting monsters at level 100 (max evolution).

Soundtrack and Sound Effects[edit | edit source]

The game has a Soundtrack, which is currently mostly non-original music sourced from Open Game Art. There is no objection to having original music, but it hasn't been contributed so far.

OGG is the preferred format for music and sound files, but WAV and MP3 are also permitted.

Terminology[edit | edit source]

  • Type or Element
  • Morphing or evolving is what tuxemon do when they change from one life stage to another
  • A single example of a creature is called an individual or a character. For example, "Beachcomber Harry's level 5 Memnomnom" is an individual creature.
  • A variety or species is all creatures of that category. For example, "Memnomnom" is a variety of tuxemon.
  • A family of creatures is a variety and all its morphs. For example, Memnomnom, Miaownolith, Criniotherme and Pyraminx are all varieties in the "Memnomnom family".

Creatures[edit | edit source]

Creatures, also called tuxemon or monsters, are the beings that the protagonist catches and battles.

We currently have complete sprites for over a hundred creatures, including all that we need for the game. Others are always welcome.

Variety[edit | edit source]

Creatures of a particular variety have a number of things in common:

Stats[edit | edit source]

An individual tuxemon's stats are calculated in a formula that accounts for four factors:

There are six stats:

  • Speed: The higher your Speed, the quicker you act in a round.
  • Melee: Increased damage from melee techniques
  • Armour: Reduced damage from melee techniques
  • Ranged: Increased damage from ranged techniques
  • Dodge: Reduced damage from ranged techniques
  • HP: How much damage you can take

Techniques[edit | edit source]

Techniques are discrete attacks, blocks, tricks and other manoeuvres that tuxemon perform in combat. Every tuxemon knows between one and four techniques. Each creature learns techniques based on their variety. Some techniques are learned from leveling up ("nature techniques"), others require training ("nurture techniques"). That training can either come from an expensive, one-use Combat Codex or from another creature that also knows that technique (Technique Teachers).

Types[edit | edit source]

Techniques and monsters have one or two types, reflecting their nature, behaviour and structure. Tuxemon has five types - Fire, Earth, Metal, Water and Wood - and the non-type of Aether.

A creature's type determines which type of techniques it is vulnerable towards, and which it is tough against. For example, a Wood creature that is hit by a Metal technique takes double damage. If it were hit by a Water technique, it would instead take half damage.

Techniques can also have the Aether type, which means that they take the type(s) of their user.

Damage Multipliers[edit | edit source]

When a technique is used on a monster, the type(s) of the technique is compared to the type(s) of the monster. In some cases, this results in the technique's damage being multiplied or divided.

Sprites[edit | edit source]

Tuxemon have four sprite sets:

  • Front Sprite: This 64x64 pixel sprite is what appears in the tuxemon's Tuxepedia entry, the individual creature's info page, and when you face the tuxemon in battle.
  • Back Sprite: This 64x64 pixel sprite is what appears when the tuxemon faces a creature in battle.
  • Face Sprites: These two 24x24 pixel sprites make an animation, which is used in menus to provide a readily-identifiable icon for the tuxemon.
  • Overland Sprites: These 16x24 pixel sprites make walking animations, which are used if the tuxemon is ever wandering around the Overworld (i.e. the map). There are generic overland sprite sets that can be used for any tuxemon that need overland sprites that do not have their own.

At this time, there are no palette swaps, like for shiny and genetically engineered Creos in EvoCreo.

Morphing[edit | edit source]

Main article: Morphing

Capturing tuxemon[edit | edit source]

Main article: Capturing

Capture 1.gif
Capture 3.gif

Capture Devices can be used in battle to attempt to capture the tuxemon you are fighting (only if the tuxemon does not currently have a trainer). The device is consumed regardless of whether the capture is successful.

Fusions[edit | edit source]

Fusions, based on a similar system to that used by Alex Onsager, are a key part of the main plot but are not yet implemented. They would take the face of one tuxemon and the body of another, and apply the palette of the face to the rest of the body.

The Onsager technique adjusts the size of the face before applying it, meaning it can no longer be displayed at its native pixel size. We haven't resolved this problem yet.

Some manual fusions have been created as proofs of concept.

Threats[edit | edit source]

Although not yet fully developed, there is an idea that some entities may be able to be battled, but will not be tuxemon. For example, your tuxemon may fight a martial artist, a killer robot, or a gunslinger.

These would not be able to be caught (so they don't need back or face sprites), but would otherwise behave like tuxemon.

Battle[edit | edit source]

Order[edit | edit source]

Main article: Combat Order

Combat actions are sorted by category (healing, swapping, attacking, etc) and monster Speed.

To ensure that multiplayer is compatible, rules can't be things like "Protagonist goes first".

Dual Duels[edit | edit source]

A couple of places in the story anticipate that double battles will exist. On Route 5 the Little Heirs and the Dynamic Dynasts represent two trainers each, and at Omnichannel HQ it's expected that you'll team up with your Rivals to fight a series of double battles. Category:Duo is the category for sprites for double battles.

People[edit | edit source]

The humans of the world - the protagonist and any NPCs. These fall into two classes: ordinary people and trainers. These behave differently.

Regardless, all people have a profession, which determines their overland sprite and (if they are trainers) their battle sprite. They also all have dialogue. Trainers will also have a team, which is the tuxemon that they carry with them that they will battle you with.

There are currently sprites for dozens of professions.

Templates[edit | edit source]

Trainers are written in the following template:

Profession FIRSTNAME:

  • Dialogue when first confronted
  • Team of tuxemon
  • Dialogue when defeated

No dialogue is needed if the trainer defeats the protagonist, because the protagonist just blacks out.

Ordinary people are written in the following template:

Profession FIRSTNAME:

  • Dialogue
  • If dialogue is different after the first conversation, subsequent dialogue goes here

Character Maker[edit | edit source]

The Character Maker allows you to design an overland sprite by picking and choosing different features.

Items[edit | edit source]

The protagonist has money, most of which comes from defeating other trainers in battle. This money can be used to buy certain items; other items come from completing quests, or are found by exploring the map.

Code, Programming and Technical[edit | edit source]

  • The game is nominally 256 x 144 pixels, but is displayed at five times that size. Text is displayed at a higher resolution (so "five pixel high" text is actually 25 pixels high, with all the detail and nuance that that suggests).

Features[edit | edit source]

  • In-game language translations
  • Allows up to three save files (for that retro GameBoy experience).

Combat[edit | edit source]

Networking[edit | edit source]

Tuxemon Mobile Controller Project[edit | edit source]

Would allow you to use your Android phone or tablet as a controller for Tuxemon.

Related (open source) projects[edit | edit source]