├── 01.home ├── 01.general-faq │ └── docs.md ├── 02.technical-faq │ └── docs.md ├── 03.code-of-conduct │ └── docs.md ├── chapter.md └── default.md ├── 02.client ├── 01.maniaplanet-launcher-configuration │ ├── En_configuration.png │ ├── En_configuration_audio.png │ ├── En_configuration_display.png │ ├── En_configuration_game.png │ ├── En_configuration_inputs.png │ ├── En_configuration_network.png │ ├── En_configuration_p2p.png │ ├── En_defaults.png │ └── docs.md ├── 02.text-formatting │ ├── Colorname.jpg │ └── docs.md ├── 03.keyboard-shortcuts │ └── docs.md ├── 04.maniaplanet-protocol │ └── docs.md ├── 05.command-line-flags │ └── docs.md ├── 06.performance-profiler │ ├── debug1.jpg │ ├── debug2.jpg │ ├── debug3.jpg │ ├── debug4.jpg │ ├── debug5.jpg │ └── docs.md ├── 07.planets │ ├── docs.md │ └── mp4_planets.jpg └── chapter.md ├── 03.customization ├── 01.create-a-custom-horn │ ├── Horn_img_audacity.jpg │ ├── Horn_img_audacity2.jpg │ ├── Horn_img_audacity3.jpg │ ├── Horn_img_audacity4.jpg │ ├── Horn_img_selectHorn.jpg │ └── docs.md ├── 02.create-a-custom-sticker │ ├── Sticker_img_explorer.jpg │ ├── Sticker_img_ps.jpg │ ├── Sticker_img_ps2.jpg │ ├── Sticker_img_ps3.jpg │ ├── Sticker_img_ps4.jpg │ ├── Sticker_img_ps5.jpg │ ├── Sticker_img_ps6.jpg │ ├── Sticker_img_ps7.jpg │ ├── Sticker_img_ps8.jpg │ ├── Sticker_result.jpg │ └── docs.md ├── 03.create-an-emblem │ ├── Emblem_SaveSettings.png │ ├── Emblem_Template.png │ └── docs.md ├── 04.create-a-player-skin │ ├── docs.md │ └── joker_skin.png ├── 05.using-custom-content │ └── docs.md ├── 06.importer │ ├── 01.import-a-car-skin │ │ ├── carskin_DetailsDamage.jpg │ │ ├── carskin_DetailsDamage_alpha.jpg │ │ ├── carskin_DetailsDiffuse.jpg │ │ ├── carskin_DetailsDiffuse_alpha.jpg │ │ ├── carskin_DetailsDirty.jpg │ │ ├── carskin_DetailsDirty_alpha.jpg │ │ ├── carskin_DetailsIllum.jpg │ │ ├── carskin_DetailsIllum_alpha.jpg │ │ ├── carskin_FakeShad.jpg │ │ ├── carskin_Icon.jpg │ │ ├── carskin_Icon_alpha.jpg │ │ ├── carskin_ProjWheelShad.jpg │ │ ├── carskin_SkinDamage.jpg │ │ ├── carskin_SkinDamage_alpha.jpg │ │ ├── carskin_SkinDiffuse.jpg │ │ ├── carskin_SkinDiffuse_alpha.jpg │ │ ├── carskin_SkinDirty.jpg │ │ ├── carskin_SkinDirty_alpha.jpg │ │ ├── carskin_WheelsDiffuse.jpg │ │ ├── carskin_WheelsDiffuse_alpha.jpg │ │ ├── carskin_WheelsDirty.jpg │ │ ├── carskin_WheelsDirty_alpha.jpg │ │ ├── carskin_alphasource.jpg │ │ ├── carskin_cmd.jpg │ │ ├── carskin_copydialog.jpg │ │ ├── carskin_figure1.jpg │ │ ├── carskin_figure2.jpg │ │ ├── carskin_figure3.jpg │ │ ├── carskin_figure4.jpg │ │ ├── carskin_figure5.jpg │ │ ├── carskin_figure6.jpg │ │ ├── carskin_figure7.jpg │ │ ├── carskin_figure8.jpg │ │ ├── carskin_importfolder.jpg │ │ ├── carskin_pivots.png │ │ ├── carskin_resetxform.png │ │ ├── carskin_screenshot.jpg │ │ ├── carskin_skylight.png │ │ ├── carskin_success.jpg │ │ ├── carskin_uvafter.jpg │ │ ├── carskin_uvbefore.jpg │ │ ├── docs.md │ │ └── helpers.zip │ ├── 02.import-a-character-skin │ │ └── docs.md │ ├── 03.import-an-item │ │ └── docs.md │ ├── 04.import-a-mesh │ │ └── docs.md │ ├── 05.import-a-font │ │ └── docs.md │ └── docs.md └── chapter.md ├── 04.dedicated-server ├── 01.getting-started │ └── docs.md ├── 02.server-plugin │ └── docs.md ├── 03.matchmaking │ └── docs.md ├── 04.relay-server │ └── docs.md ├── 05.frequent-errors │ └── docs.md ├── 06.references │ ├── 01.command-line │ │ └── docs.md │ ├── 02.dedicated-config │ │ └── docs.md │ ├── 03.title-ids │ │ └── docs.md │ ├── 04.settings-list-for-nadeo-gamemodes │ │ └── docs.md │ ├── 05.xml-rpc-methods │ │ └── docs.md │ ├── 06.xml-rpc-callbacks │ │ └── docs.md │ ├── 07.xml-rpc-scripts │ │ └── docs.md │ ├── 08.apt-repository │ │ └── docs.md │ └── chapter.md └── chapter.md ├── 05.manialink ├── 01.getting-started │ ├── browser.png │ ├── docs.md │ └── urlbar.png ├── 02.maniacode │ └── docs.md ├── 03.maniaapp │ └── docs.md ├── 04.create-a-manialink-vr-friendly │ └── docs.md ├── 05.customize-a-scoretable │ ├── docs.md │ ├── mp4_editors.JPG │ ├── mp4_editors_title.JPG │ ├── mp4_home.JPG │ ├── mp4_module_home.JPG │ └── mp4_module_scoretable.JPG ├── 06.manialink-example │ └── docs.md ├── 07.specific-server-manialink │ ├── docs.md │ ├── player_avatar.jpg │ ├── player_country.jpg │ └── player_echelon.jpg ├── 08.references │ ├── 01.actions-in-manialink │ │ └── docs.md │ ├── 02.manialink-styles │ │ └── docs.md │ ├── 03.symbols-reference │ │ ├── docs.md │ │ └── mp4_symbols.JPG │ └── chapter.md └── chapter.md ├── 06.map-editor ├── 01.how-to-use-the-map-editor │ ├── Map_Editor_UI2_Edited.jpg │ ├── Map_Editor_UI_Edited.jpg │ └── docs.md ├── 02.embed-a-block-in-a-map │ ├── CanyonMaterials+Textures.pdf │ ├── Canyon_D-textures-overview.jpg │ ├── arrow-example-files.zip │ ├── blender-shorcuts.pdf │ └── docs.md └── chapter.md ├── 07.mediatracker ├── 01.using-the-mediatracker │ ├── docs.md │ ├── mp4_mediatracker3.jpg │ ├── mp4_mediatracker4.jpg │ └── mp4_mediatracker5.jpg ├── 02.using-the-mediatracker-as-a-screenshot-tool │ ├── docs.md │ ├── mp4_editors_canyon_edited.jpg │ ├── mp4_editors_title_canyon_reEdited.jpg │ ├── mp4_editors_title_replay_canyon.JPG │ ├── mp4_editors_title_replay_edit_canyon.JPG │ └── mp4_home_canyon_edited.jpg ├── 03.batching-videos │ └── docs.md └── chapter.md ├── 08.maniascript ├── 01.syntax-basics │ └── docs.md ├── 02.create-a-basic-shootmania-game-mode │ ├── Melee.Script.txt │ ├── docs.md │ └── mp4_create_server_gamemode_edited.jpg ├── 03.specifying-parameters-for-a-player-shootmania │ └── docs.md ├── 04.using-bots-in-shootmania │ └── docs.md ├── 05.display-messages-on-the-hud │ └── docs.md ├── 06.landmarks │ └── docs.md ├── 07.using-the-pole-in-the-script │ └── docs.md ├── 08.create-and-spawn-an-object │ └── docs.md ├── 09.drop-an-object-from-a-player │ └── docs.md ├── 10.the-actions-from-the-actionmaker-in-the-script │ └── docs.md ├── 11.manialink-in-maniascript │ └── docs.md ├── 12.maniascript-in-manialink │ └── docs.md ├── 13.using-layers │ └── docs.md ├── 14.sending-maniascript-script-vars-to-maniascript-manialink-vars │ └── docs.md ├── 15.shootmania-script-example │ └── docs.md ├── 16.tools-to-code-in-maniascript │ └── docs.md ├── 17.references │ ├── 01.maniascript-references │ │ ├── doc-exemple.png │ │ └── docs.md │ ├── 02.maniascript-values │ │ └── docs.md │ ├── 03.reference-card │ │ └── docs.md │ ├── 04.links │ │ └── docs.md │ ├── 05.maniascript-conventions │ │ └── docs.md │ └── chapter.md └── chapter.md ├── 09.mesh-modeler ├── 01.getting-started │ └── docs.md ├── 02.item-editor │ └── docs.md ├── 03.block-editor │ └── docs.md ├── 04.mesh-modeler-overview │ └── docs.md └── chapter.md ├── 10.actionmaker ├── 01.create-a-weapon │ ├── AM_CustomProjectileCore.jpg │ ├── AM_CustomProjectileExplosionDebris.jpg │ ├── AM_CustomProjectileExplosionPower.jpg │ ├── AM_CustomProjectileGameplayBullet.jpg │ ├── AM_CustomProjectileGameplayExplosion.jpg │ ├── AM_CustomProjectileTrail.jpg │ ├── Edit_AM_CustomProjectileCore.jpg │ ├── Edit_AM_Home.jpg │ ├── Edit_AM_NewWeapon.jpg │ ├── actionmaker_kamehameha.gif │ └── docs.md └── chapter.md ├── 11.title-pack ├── 01.getting-started │ ├── Title_LogosLegend.png │ └── docs.md ├── 01.how-to-create-a-title-pack │ ├── Title_LogosLegend.png │ └── docs.md ├── 02.xml-description │ └── docs.md ├── 03.mood │ └── docs.md ├── 04.shootmania-moods │ └── docs.md ├── 05.trackmania-moods │ └── docs.md └── chapter.md ├── 12.nadeo-importer ├── 01.getting-started │ └── docs.md ├── 02.import-a-mesh │ └── docs.md ├── 03.how-to-make-a-specularmap-diffusemap-for-objects │ └── docs.md ├── 04.how-to-make-a-normalmap │ └── docs.md ├── 05.how-to-set-up-custom-lights │ └── docs.md └── chapter.md ├── 13.web-services ├── 01.oauth2 │ └── docs.md ├── 02.authentification │ └── docs.md ├── 03.routes │ └── docs.md └── chapter.md ├── 14.misc ├── 01.eula-world │ └── docs.md ├── 02.eula-france │ └── docs.md ├── 03.eula-us-uk │ └── docs.md └── chapter.md ├── README.md └── index.html /01.home/03.code-of-conduct/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Trackmania and Shootmania games code of conduct' 3 | menu: 'Code of conduct' 4 | process: 5 | markdown: true 6 | twig: true 7 | taxonomy: 8 | category: 9 | - docs 10 | --- 11 | 12 | This code of conduct is for Trackmania and Shootmania games (the "Games") and is supplemental to the Ubisoft Terms of Use, [posted here](https://legal.ubi.com/termsofuse/) ([https://legal.ubi.com/termsofuse/](https://legal.ubi.com/termsofuse/)), where applicable. Please refer to such terms for an in-depth breakdown of our conduct rules. Capitalized terms used in this Code of Conduct shall have the respective meanings specified in the Terms of Use. 13 | 14 | ### RESPONSIBILITY: 15 | 16 | Ubisoft cannot be held responsible for the actions or comments made by Users in the various areas of the Games, forums, or other social media outlets. Ubisoft reserves the right to remove any and all content published by a User without prior warning or notification. 17 | 18 | We strongly advise you not to give personal or Account information to anyone. This includes information that can be used to identify you (social security number, telephone number, physical address, etc.) or information that may be used to compromise your Account (personal email address, answers to your security questions, etc.). 19 | 20 | **Please note that a representative of Ubisoft will never ask you for your password.** 21 | 22 | ### CODE OF CONDUCT: 23 | 24 | When you play any of the Games, you must respect other Users and their user rights. The following points will be enforced by the Ubisoft staff: 25 | 26 | - Any suspected breach of the Code of Conduct or Terms of Use will lead to an investigation. **Ubisoft reserves the right to suspend, ban, or delete any User's Account without prior warning or notice.** 27 | - When using the services provided by Ubisoft, Users may not engage in or encourage any illegal behavior or communications concerning such. 28 | - Users will follow all instructions given to them by the Ubisoft staff. Non-compliance of the User regarding any request made by a Ubisoft employee will be considered a breach of the Code of Conduct, and may lead to Account suspension or revocation. 29 | - The User will respect the rules detailed in this Code of Conduct when using the services offered by Ubisoft and the Games. The following list of forbidden conduct gives examples of unacceptable behavior, but should not be considered exhaustive. 30 | 31 | ### FORBIDDEN CONDUCT: 32 | 33 | The following actions are forbidden, and can lead to a disciplinary action in accordance with the Disciplinary Policy outlined below. 34 | 35 | - Harassing or bullying other players via verbal or written communications. 36 | - Any language or content deemed illegal, dangerous, threatening, abusive, obscene, vulgar, defamatory, hateful, racist, sexist, ethically offensive or constituting harassment. 37 | - Impersonation of any other player or Ubisoft employee. 38 | - Any conduct which interrupts the general flow of Gameplay in the Game client, forum, or any other Ubisoft medium. 39 | - Verbal or written abuse targeted toward a Ubisoft employee. 40 | - Use of macros. 41 | - Any attempt to edit, corrupt or change Games or server code. Any such behavior will result in the immediate cancellation of the Account, and may even give rise to personal liability and/or penal penalties. 42 | - Use of third-party hacking, cheating or botting clients. 43 | - The purchase of in Games benefits, including but not limited to "MMR boosting services" from unlicensed vendors, as well as the promotion of such services. 44 | - Exploitation of any new or known bug or glitch for personal gain is strictly forbidden and may result in character rollback, Account suspension or revocation. 45 | 46 | **USER NAMES** 47 | 48 | The following rules clarify the types of names that you may not use: 49 | 50 | - You may not use a name that is contrary to the Code of Conduct. This includes the use of names of a hateful, racist, defamatory, ethnically offensive, obscene, vulgar or sexually explicit nature, as well as any other offensive wording. 51 | - You may not use names that lead to the harassment or slander of other Users. 52 | - You may not use the name of any Ubisoft employee. 53 | - You may not use a name of a character, object or product covered by copyright or trademark. 54 | - You may not use a name from popular culture or the media. 55 | - You may not use a name with a religious or historical connotation. 56 | - You may not use a name linked to a terrorist organization or activity. 57 | - Ubisoft strictly reserves the right to use the names linked to the Games license. 58 | - You may not use a name that refers to an illness, medicine, drug or alcohol. 59 | - You may not use any name that breaks any of the aforementioned rules via the association of the first name and surname. 60 | - You may not use a name containing spelling mistakes or written in such a way as to break one of the aforementioned rules. 61 | 62 | ### DISCIPLINARY POLICY: 63 | 64 | In the event of a Code of Conduct violation, disciplinary action will be taken. Depending on the seriousness of the violation, sanctions can range from a warning to a permanent ban. 65 | 66 | Below are examples of behavior that could lead to your Account being banned from playing online or restricting your access in other ways from the Games: 67 | 68 | - Cheating / Modding / Hacking: Player is running a modified or otherwise unauthorized version of the Game client or a third party software which provides any sort of unfair advantage or causing detriment to other players' experience. 69 | - Offensive Language or Behavior / Threats: Posting or publishing (public forums, private chats or VOIP) any language or content that is in violation of this Code of Conduct. 70 | - Harassment: Harassing or serious bullying other players via verbal or written communications in the in-Game chat, and outside the Games (public forum). 71 | - Advertising / Spamming: Disrupting the conversation flow for personal or commercial purposes with repeated posting of a similar nature. 72 | - Phishing / Scamming: Any attempt to fraud or mislead other players to gain personal or financial advantage, including but not limited to: personal information, credit cards etc. 73 | 74 | ### DISPUTING ACCOUNT SANCTIONS: 75 | 76 | If you have a question or wish to dispute an Account sanction that you have incurred, please [send a request to Customer Support](https://support.ubi.com/en-us/Cases/New) (https://support.ubi.com/). Please be sure to include all relevant information. We will reply to your questions as promptly as possible. 77 | 78 | ### ACCOUNT SECURITY: 79 | 80 | The User alone is responsible for the security of his/her Account, including protecting his/her system and Account from being compromised. 81 | 82 | ### PLEASE RESPECT THE CODE OF CONDUCT: 83 | 84 | Help us make this site, the Games and the forums a welcoming community space. Respect the Code of Conduct and encourage others to do the same. If you meet users who are not familiar with the Code of Conduct, politely encourage them to read it. 85 | -------------------------------------------------------------------------------- /01.home/chapter.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Home 3 | taxonomy: 4 | category: 5 | - docs 6 | --- 7 | 8 | # Maniaplanet Support 9 | 10 | The Maniaplanet documentation website is created to help using the tools of the Maniaplanet game operating system. This site will describe how to do several things, such as: 11 | 12 | * [Setup a dedicated server](/dedicated-server/getting-started) 13 | * [How to setup a MatchMaking infrastructure](/dedicated-server/matchmaking) 14 | * Using the different tools of Maniaplanet like the [ActionMaker](/actionmaker), the [importer](/nadeo-importer/getting-started) and more. 15 | * Learn to code a [Manialink](/manialink/getting-started) and to learn the [ManiaScript language](/maniascript/syntax-basics). 16 | * How to create a [Title Pack](/title-pack), an advanced pack of contents which can include graphics, custom gamemodes, custom weapons, and more, created by the players! See this as an advanced modtool. 17 | -------------------------------------------------------------------------------- /01.home/default.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Home 3 | --- 4 | 5 | # Grav is Running! 6 | ## You have installed **Grav** successfully 7 | 8 | Congratulations! You have installed the **Base Grav Package** that provides a **simple page** and the default **antimatter** theme to get you started. 9 | 10 | !!! If you want a more **full-featured** base install, you should check out [**Skeleton** packages available in the downloads](http://getgrav.org/downloads). 11 | 12 | ### Find out all about Grav 13 | 14 | * Learn about **Grav** by checking out our dedicated [Learn Grav](http://learn.getgrav.org) site. 15 | * Download **plugins**, **themes**, as well as other Grav **skeleton** packages from the [Grav Downloads](http://getgrav.org/downloads) page. 16 | * Check out our [Grav Development Blog](http://getgrav.org/blog) to find out the latest goings on in the Grav-verse. 17 | 18 | ### Edit this Page 19 | 20 | To edit this page, simply navigate to the folder you installed **Grav** into, and then browse to the `user/pages/01.home` folder and open the `default.md` file in your [editor of choice](http://learn.getgrav.org/basics/requirements). You will see the content of this page in [Markdown format](http://learn.getgrav.org/content/markdown). 21 | 22 | ### Create a New Page 23 | 24 | Creating a new page is a simple affair in **Grav**. Simply follow these simple steps: 25 | 26 | 1. Navigate to your pages folder: `user/pages/` and create a new folder. In this example, we will use [explicit default ordering](http://learn.getgrav.org/content/content-pages) and call the folder `02.mypage`. 27 | 2. Launch your text editor and paste in the following sample code: 28 | 29 | --- 30 | title: My New Page 31 | --- 32 | # My New Page! 33 | 34 | This is the body of **my new page** and I can easily use _Markdown_ syntax here. 35 | 36 | 3. Save this file in the `user/pages/02.mypage/` folder as `default.md`. This will tell **Grav** to render the page using the **default** template. 37 | 4. That is it! Reload your browser to see your new page in the menu. 38 | 39 | ! NOTE: The page will automatically show up in the Menu after the "Home" menu item. If you wish to change the name that shows up in the Menu, simple add: `menu: My Page` between the dashes in the page content. This is called the YAML front matter, and it is where you configure page-specific options. 40 | -------------------------------------------------------------------------------- /02.client/01.maniaplanet-launcher-configuration/En_configuration.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/01.maniaplanet-launcher-configuration/En_configuration.png -------------------------------------------------------------------------------- /02.client/01.maniaplanet-launcher-configuration/En_configuration_audio.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/01.maniaplanet-launcher-configuration/En_configuration_audio.png -------------------------------------------------------------------------------- /02.client/01.maniaplanet-launcher-configuration/En_configuration_display.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/01.maniaplanet-launcher-configuration/En_configuration_display.png -------------------------------------------------------------------------------- /02.client/01.maniaplanet-launcher-configuration/En_configuration_game.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/01.maniaplanet-launcher-configuration/En_configuration_game.png -------------------------------------------------------------------------------- /02.client/01.maniaplanet-launcher-configuration/En_configuration_inputs.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/01.maniaplanet-launcher-configuration/En_configuration_inputs.png -------------------------------------------------------------------------------- /02.client/01.maniaplanet-launcher-configuration/En_configuration_network.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/01.maniaplanet-launcher-configuration/En_configuration_network.png -------------------------------------------------------------------------------- /02.client/01.maniaplanet-launcher-configuration/En_configuration_p2p.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/01.maniaplanet-launcher-configuration/En_configuration_p2p.png -------------------------------------------------------------------------------- /02.client/01.maniaplanet-launcher-configuration/En_defaults.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/01.maniaplanet-launcher-configuration/En_defaults.png -------------------------------------------------------------------------------- /02.client/02.text-formatting/Colorname.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/02.text-formatting/Colorname.jpg -------------------------------------------------------------------------------- /02.client/02.text-formatting/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Text formatting' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: 8 | - docs 9 | --- 10 | 11 | Whenever you type text in Maniaplanet, you can customize the text formatting with simple control characters. You can for example use this to customize your nickname in the profile menu. 12 | 13 | ## Control characters 14 | 15 | | Control character | Formatting | 16 | | :----- | :----- | 17 | | ``$w`` | Wide | 18 | | ``$n`` | Narrow | 19 | | ``$o`` | Bold | 20 | | ``$i`` | Italic | 21 | | ``$t`` | Uppercase | 22 | | ``$s`` | Drop shadow | 23 | | ``$g`` | Reset to default color | 24 | | ``$z`` | Reset to default text style | 25 | | ``$$`` | Display a $ character | 26 | 27 | ## Colors 28 | 29 | You can use colors with a 3-character hexadecimal code of the desired colour appended to the ``$`` sign: 30 | 31 | - Each 3 characters can have 16 values from 0 to f (`0123456789abcdef`). 32 | - The first character is the red colour pallet, then green and blue. 33 | 34 | Here a few examples 35 | 36 | - $000: black 37 | - $f00: red 38 | - $0f0: green 39 | - $00f: blue 40 | - $f80: orange 41 | - $ff0: yellow 42 | - $f0f: pink 43 | - $0ff: light blue 44 | - $888: grey 45 | - $fff: white 46 | 47 | Here is a cheatsheet: 48 | 49 | ![](Colorname.jpg) 50 | 51 | ## Examples 52 | 53 | - `$08FNadeo` will display Nadeo (ie. blue text) 54 | - `$o$t$08FNadeo` will display NADEO (ie. bold, uppercase and blue text) 55 | 56 | ## Resources 57 | 58 | - [TMU KrazyColors](http://kc.jfreu.com/) is a Website to help you compose your custom nickname. 59 | -------------------------------------------------------------------------------- /02.client/03.keyboard-shortcuts/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Keyboard shortcuts' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: 8 | - docs 9 | --- 10 | 11 | [TOC] 12 | 13 | ## Script editor 14 | 15 | * Scroll Lock: open the script editor 16 | * Ctrl + g: open the log window / open the debug window / close the debug window 17 | * Ctrl + a: select all 18 | * Ctrl + z: undo 19 | * Ctrl + y: redo 20 | * Ctrl + f: search 21 | * Ctrl + g: go to line # 22 | * Ctrl + h: search and replace 23 | * Ctrl + c: copy the selection 24 | * Ctrl + x: cut the selection 25 | * Ctrl + v: paste the selection 26 | * Ctrl + home: go to the beginning the script 27 | * Ctrl + end: go to the end of the script 28 | * Ctrl + numpad+: increase the font size 29 | * Ctrl + numpad-: decrease the font size 30 | * Ctrl + F3: quick search next on the selection 31 | * Ctrl + shift + F3: quick search previous on the selection 32 | 33 | ## Media Tracker 34 | 35 | * TAB: hide / show the GUI 36 | * Direction arrows: move custom camera position 37 | * Pg Up: raise the camera position 38 | * Pg Dn: lower the camera position 39 | * numpad+: increase movement speed when positioning the camera 40 | * numpad-: decrease movement speed when positioning the camera 41 | * numpad/ (also numpad*): jumps between start and end of the currently selected track 42 | * Pos1 (or home): jumps to the start of the complete timeline 43 | * End: jumps to the end of the complete timeline 44 | * Backspace: jumps to the start of the complete timeline and starts the playback at normal speed 45 | * Enter: inserts a key at the actual time to the currently selected track 46 | * Ctrl + H: Show helpers (press again to hide helpers) 47 | 48 | ## Painter / Model selection 49 | 50 | ### Common 51 | 52 | * H : Show / hide help 53 | * Ctrl + A : Switch between auto / manual camera 54 | * Ctrl + H : Show / hide helpers 55 | * Ctrl + R : Reload skin 56 | * Ctrl + X : Show / hide debug info 57 | * Ctrl + Up : Next LOD 58 | * Ctrl + Down : Previous LOD 59 | * Ctrl + Right : Next skin 60 | * Ctrl + Left : Previous skin 61 | 62 | 63 | ### TrackMania 64 | 65 | * Ctrl + B : Switch between brake / no brake 66 | * Ctrl + C : Show / hide collision 67 | * Ctrl + D : Switch between no damage / full damage 68 | * Ctrl + F : Show / hide refs 69 | * Ctrl + I : Switch between dirty / not dirty 70 | * Ctrl + J : Detach / attach parts 71 | * Ctrl + L : Switch between day / night 72 | * Ctrl + M : Damper compression 73 | * Ctrl + O : Open / close parts 74 | * Ctrl + T : Switch between wheels rotate / static 75 | * Ctrl + V : Show / hide car 76 | * Ctrl + W : Show / hide Wireframe 77 | 78 | 79 | ### ShootMania 80 | 81 | * Ctrl + E : Next evolution models 82 | * Ctrl + K : Show / hide skeleton 83 | * Ctrl + S : Switch between speaking / not speaking 84 | * Ctrl + T : Switch between teams 85 | * Shift + E : Switch between idle / eliminated animation 86 | * Shift + P : Switch between idle / Ref pose 87 | * Shift + S : Next energy step 88 | 89 | 90 | ## Map Editor 91 | 92 | ### General 93 | 94 | * F1 : Select terraforming mode 95 | * F2 : Select block placement mode. If enabled in the extended tools (Hammer symbol) at "Experimental Features", toggles between simple block placement, Airmapping and Blockmixing 96 | * F3 : Skin mode. Allows to change textures on blocks with panels 97 | * F4 : Items mode: allows to place additional items, as well as third-party items 98 | * F5 : Macroblock mode 99 | * H : shows helper dialog 100 | * M : toggles display of raster (On AZERTY keyboard use , instead) 101 | * P : opens Plugins mode 102 | * R : revert a previous usge of undo 103 | * U : undo a previous block operation 104 | * Z : toggles underground view to make tunnels more easily editable (On AZERTY keyboard use W instead, and on QWERTZ keyboard use Y) 105 | * ALT + Left mouse button : move the map 106 | * ALT + Right mouse button : rotate the map 107 | * ALT + Mouse wheel : zoom in / zoom out the map 108 | * Del : delete block at the cursor position 109 | * Enter : test mode. vehicle / player model will be placed at the cursor 110 | * Pg Up (or Mouse wheel up): raise the cursor position 111 | * Pg Dn (or Mouse wheel down): lower the cursor position 112 | * Space (or Left mouse button): places selected block type at the cursor position 113 | * Right Ctrl (or Right mouse button) : rotates block selection 114 | * Left Ctrl : Record or Playback Editors input replay (on New Map selection) 115 | * TAB : hide / show block selection menus 116 | 117 | ### Terraforming 118 | 119 | * BACKSPACE : Delete all kinds of terraforming, all the other blocks and items are not affected. 120 | * Ctrl + left mouse click : selects block type at the cursor position 121 | * X + left mouse click : deletes block at the cursor position 122 | * C : Switches to Macroblock selection mode 123 | 124 | ### Block mode 125 | 126 | * BACKSPACE: Delete all blocks placed in this mode. Landscape and items are not affected. 127 | * X + left mouse click: deletes block at the cursor position 128 | 129 | ### Item mode 130 | 131 | * BACKSPACE: Delete all blocks placed in this mode. Landscape and items are not affected. 132 | * Ctrl + left mouse click: selects block type at the cursor position 133 | * X + left mouse click: deletes block at the cursor position 134 | * Arrow keys (not those on the Numeric pad!), as well as Numpad- and Numpad+: rotate item along x, y and z axes. Some items only allow rotation along vertical axis. 135 | * Numpad/: reset item orientation to default 136 | 137 | ### Macroblock mode 138 | 139 | * BACKSPACE: Delete all blocks in the selection 140 | * Ctrl + left mouse click: selects block type at the cursor position 141 | 142 | ### Test Mode: 143 | 144 | * F: FlyMode -------------------------------------------------------------------------------- /02.client/04.maniaplanet-protocol/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Maniaplanet Protocol (maniaplanet://)' 3 | taxonomy: 4 | category: 5 | - docs 6 | --- 7 | 8 | ## maniaplanet:// 9 | 10 | Use the maniaplanet:// protocol to access various functionalities from a simple URI. 11 | 12 | | command | description | 13 | |:-----------------------------------------------:|:--------------------------------------------------------------------------------------------------------:| 14 | | maniaplanet://#join=serverlogin@TITLEID | Join a specific server | 15 | | maniaplanet://#spectate=serverlogin | Logs you into a server as spectator from an external link | 16 | | maniaplanet://#qjoin=serverlogin@TITLEID | QuickJoin a specific server without the normal window before joining a server | 17 | | maniaplanet://#qspectate=serverlogin | QuickSpectate a server to join as Spectator | 18 | | maniaplanet://#joinasreferee=serverlogin | Join a specific server as referee | 19 | | maniaplanet://#addfavorite=serverlogin | Add a specific server as favorite server | 20 | | maniaplanet://#score=scoremeta | Link is generated in game to send scores that one can challenge on another computer | 21 | | maniaplanet://#opponent=login:map:group@TITLEID | play a campaign track against an opponent | 22 | | maniaplanet://#campaign=map@TITLEID | Play a specific map of the title's campaign | 23 | | maniaplanet://#menutitle=TITLEID | Will open the menuTitle of a TitleUID | 24 | | maniaplanet://#openstore=TITLEID | Will open the shop to buy the game, depending on the distribution platform. (not useful for user titles) | 25 | | maniaplanet://#menustations=* | * can be home, play, store, options | 26 | | maniaplanet://#addbuddy=login | Add a buddy | 27 | | maniaplanet://#invitebuddy=login | Invite a buddy | 28 | | maniaplanet://#mailto=login | Send a message to a preferred login with the in-game mail system | 29 | | maniaplanet://url | Open an URL into the in-game browser | 30 | | maniaplanet:///:manialink | Open a manialink into the in-game browser (please note the three | slashes and the colon) | 31 | 32 | ## TitleId? 33 | 34 | You can find the official title ids on [this table](../../dedicated-server/references/title-ids). 35 | 36 | ## Details 37 | 38 | ### For #join, #spectate, #qjoin, #qspectate: 39 | 40 | | command | description | 41 | |:----------------------------------------------:|:----------------------------------------:| 42 | | #xxx=serverlogin@TITLEID | Join a specific server | 43 | | #xxx=serverlogin:serverpassword@TITLEID | Join a private server | 44 | | #xxx=192.168.xx.xx::port@TITLEID | Join a LAN server (default port is 2350) | 45 | | #xxx=192.168.xx.xx:serverpassword:port@TITLEID | Join a private LAN server | 46 | 47 | 48 | ### for #campaign: 49 | 50 | | command | description | 51 | |:-------------------------:|:---------------------------------------------------:| 52 | | #campaign=mapname@TITLEID | play the map from the campaign matching the name | 53 | | #campaign=#5@TITLEID | play the fifth map of the campaign | 54 | | #campaign=#3,1@TITLEID | play the third map of the first group (usually A03) | 55 | 56 | 57 | ### for #menustations: 58 | 59 | | command | description | 60 | |:------------------------------------:|:----------------------------------------------------------------------:| 61 | | #menustations= | open the stations menu | 62 | | #menustations=home | open the home tab on the stations menu | 63 | | #menustations=play@TITLEID | open the play station on the title specified (if it is installed) | 64 | | #menustations=store?titleUid=TITLEID | open the store tab, on the title page (if it's published in the store) | 65 | | #menustations=store?TITLEID | open the store tab, on the title page (if it's published in the store) | 66 | 67 | 68 | ## Example 69 | 70 | `Hello ! Please join our server !` -------------------------------------------------------------------------------- /02.client/05.command-line-flags/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Command line flags' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: 8 | - docs 9 | --- 10 | 11 | | Option Name | Role | 12 | |:------------------------:|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------:| 13 | | /login=xxx | Account login to be used to play online. | 14 | | /password=xxx | Account password | 15 | | /profile=xxx | Forces using a specific profile on disk. (to avoid the profile choice dialog) | 16 | | /validation=xxx | Specifies the account validation key (the last three chracters of the player key) to be able to perform transactions with planets. | 17 | | /join=xxx | Joins a server. (xxx = the server ip adress with optional port, or the server login.) | 18 | | /spectate=xxx | Same as /join, but join as spectator. | 19 | | /joinasreferee=xxx | Same as /join, but join as referee. | 20 | | /serverpassword=xxx | Password to use to join the server if the server is private. | 21 | | /silent | Skips news, etc... to allow joining a server without any user interaction. | 22 | | /file=xxx | Opens a Replay.Gbx or a Challenge.Gbx file. (xxx = full path to the file.) | 23 | | /url=xxx | Opens a maniaplanet:// url with the game. | 24 | | /shootvideo=xxx | Shoots a replay to a video file. (xxx = replay file. aboslute file name or relative to Tracks/Replays/). | 25 | | /validatepath=xxx | Mass validates all the replays in a directory (xxx = name relative to Tracks/Replays/). | 26 | | /windowless | Disable creation of the 3D viewport. (useful for batch processing with /validatepath, for instance) | 27 | | /list_benchs=xxx | Benchmarks a list of replays. (xxx = name of a text file containing the replays file names.) | 28 | | /bench=xxx | Benchmarks a replay (xxx = full path to the replay file name) (Internal: if no filename is specified, performs a quick technical benchmark for the default launcher settings) | 29 | | /computeallshadows | Computes the lightmaps for all the challenges on disk. | 30 | | /config=xxx | Use a specific ".SystemConfig.Gbx" config file. | 31 | | /userdir=xxx | Changes the default "My Documents/ManiaPlanet/" location. (either a full path, or just "exe" to use the exe directory.) | 32 | | /useexedir | Run in the directory where the executable is, instead of the current directory. | 33 | | /title=xxx | Sets the title to be used. Only this title and its subtitles will be playable. | 34 | | /testtitle=mytitle@login | Launch and test a title directly instead of going into the pack editor, selecting the pack, going to the title section and clicking on test. | 35 | | /checkdataintegrity | Launch and check for data integrity on titlepacks. | 36 | -------------------------------------------------------------------------------- /02.client/06.performance-profiler/debug1.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/06.performance-profiler/debug1.jpg -------------------------------------------------------------------------------- /02.client/06.performance-profiler/debug2.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/06.performance-profiler/debug2.jpg -------------------------------------------------------------------------------- /02.client/06.performance-profiler/debug3.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/06.performance-profiler/debug3.jpg -------------------------------------------------------------------------------- /02.client/06.performance-profiler/debug4.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/06.performance-profiler/debug4.jpg -------------------------------------------------------------------------------- /02.client/06.performance-profiler/debug5.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/06.performance-profiler/debug5.jpg -------------------------------------------------------------------------------- /02.client/06.performance-profiler/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Performance profiler' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: 8 | - docs 9 | --- 10 | 11 | 1. To start the debugger, press `Ctrl + F7` 12 | You will have an histogram in the middle of the screen, and a little window in the top left corner: 13 | ![](debug1.jpg) 14 | 15 | 2. When you have a micro freeze, you will have a slightly higher bar, click on `Paused: False` to freeze the histogram. 16 | (Press `Alt` to unlock the mouse in game) 17 | 18 | 3. When the histogram is stopped, click on the highest bar to show the detail: 19 | ![](debug2.jpg) 20 | 21 | 4. You can click on a second bar to get a comparison: 22 | ![](debug3.jpg) 23 | 24 | 5. Press `F10` and go to `MyDocument\ManiaPlanet\ScreenShots` folder to get the screenshot. 25 | 26 | Profesional tips / Advanced tips: 27 | These tips are for professionals and for bugs, issues, micro-freezes that can help advance the game-developers. 28 | 29 | 6. Press `F12` and you will see information about CPU Usage aswell as GPU Usage: 30 | ![](debug4.jpg) 31 | 32 | 7. Press `Ctrl+F11` 3 times to get the following window: 33 | ![](debug5.jpg) 34 | 35 | It will show the TCpu or TGpu. It will help Nadeo to see if it is a CPU issue or GPU one. 36 | 37 | Press `F10` to make a screenshot or do a printscreen and save it in Paint or any other graphic design tool and save it in a webformat like a .png or .jpg. -------------------------------------------------------------------------------- /02.client/07.planets/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'The Planets (ingame currency)' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: 8 | - docs 9 | --- 10 | 11 | Planets is the virtual currency for ManiaPlanet games. 12 | 13 | You can see your current total of Planets on the ManiaPlanet navigation toolbar on top of your screen. 14 | 15 | ![](./mp4_planets.jpg) 16 | 17 | ## Gain Planets 18 | There is many ways to gain Planets in ManiaPlanet: 19 | 20 | * 20 Planets at the first connexion of the day (per environment owned, i.e: Trackmania² Canyon, Trackmania² Valley, Trackmania² Lagoon, , Shootmania Storm) and 10 planets for Trackmania² Stadium 21 | * 10, 20 or/and 30 Planets following the medals that you earn in official mode in the solo campaigns of the environments (Trackmania² Canyon, Trackmania² Valley, Trackmania² Lagoon, Trackmania² Stadium) 22 | * 100 Planets when you win 1000 Ladder Points 23 | * Bonus month (20 Planets by title/day but it's not implemented yet) 24 | * Sell avatars/scripts/maps/macroblocks/skins/3D models to the players via Manialink webpages. 25 | 26 | ## Spend Planets 27 | But you can spend them in different ways too: 28 | 29 | * Several services available on the Maniaplanet website use Planets to do actions (like uploading a map, set a ladder server, test a server on the Nadeo infrastructure, etc.) 30 | * Buying customization stuff from the players in their Manialink webpages ingame. 31 | * The month Planet balance 32 | -------------------------------------------------------------------------------- /02.client/07.planets/mp4_planets.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/02.client/07.planets/mp4_planets.jpg -------------------------------------------------------------------------------- /02.client/chapter.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: Client 3 | published: true 4 | taxonomy: 5 | category: 6 | - docs 7 | --- 8 | 9 | # Client 10 | 11 | Learn about general features of the Maniaplanet client. 12 | -------------------------------------------------------------------------------- /03.customization/01.create-a-custom-horn/Horn_img_audacity.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/01.create-a-custom-horn/Horn_img_audacity.jpg -------------------------------------------------------------------------------- /03.customization/01.create-a-custom-horn/Horn_img_audacity2.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/01.create-a-custom-horn/Horn_img_audacity2.jpg -------------------------------------------------------------------------------- /03.customization/01.create-a-custom-horn/Horn_img_audacity3.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/01.create-a-custom-horn/Horn_img_audacity3.jpg -------------------------------------------------------------------------------- /03.customization/01.create-a-custom-horn/Horn_img_audacity4.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/01.create-a-custom-horn/Horn_img_audacity4.jpg -------------------------------------------------------------------------------- /03.customization/01.create-a-custom-horn/Horn_img_selectHorn.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/01.create-a-custom-horn/Horn_img_selectHorn.jpg -------------------------------------------------------------------------------- /03.customization/01.create-a-custom-horn/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Create a custom horn' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: docs 8 | --- 9 | 10 | You will need: 11 | 12 | * A sound that you want to use as your horn 13 | * Audacity 14 | 15 | First, download and install [Audacity][1] if you don't already have it. 16 | 17 | I usually get sounds/music from Youtube using [this website][2]. For this tutorial, I'll be using the .mp3 of this. 18 | 19 | Dr Dre - The Next Episode 20 | >>>> Note from Nadeo: the link has been removed for copyright reasons, we advise you to use *Creative Commons* (free) musics or sounds. You can find some on [Jamendo][3] for example 21 | 22 | >>>> Please note that the maximum length your horn can be is 10 seconds. So obviously, I won't be using the entire song. 23 | 24 | First, I'm going to extract the part of the song that I want to use. It's the "SMOKE WEED ERRYDAY" at the end of the song. 25 | 26 | So, open the .mp3 file in Audacity and select the part of the song you want to use. 27 | 28 | ![](Horn_img_audacity.jpg) 29 | 30 | Next, cut the selection (CTRL + X), then select all (CTRL + A) and delete. Then paste your selection (CTRL + V). Your selection will paste at the beginning of the track so you may have to scroll back to the start to see it. 31 | 32 | ![](Horn_img_audacity2.jpg) 33 | 34 | >>>> This is the most important part. Click on the black triangle pointing downwards to the left of the track and select Split Stereo to Mono. Then click the black X in the upper left corner of the bottom track to delete it. 35 | 36 | ![](Horn_img_audacity3.jpg) 37 | 38 | >>> Custom horns can sound low in Trackmania 2 so you can increase the gain on the track by moving the - + slider to the left of the track to make it louder. This can make the audio sound bad though. You can also try amplifying it by clicking `Effects` -> `Amplify`. 39 | 40 | Finally, click `File` -> `Export` and browse to `Documents\ManiaPlanet\Skins\Horns`. Select `WAV` (Microsoft) from the Save as type drop down menu, name it whatever you like and then click `Save`. 41 | 42 | ![](Horn_img_audacity4.jpg) 43 | 44 | Finally, load up Trackmania², click on `Profile` and then click on the `Horn` icon beside your avatar. Select `General` Horn and browse until you find your custom horn. 45 | 46 | ![](Horn_img_selectHorn.jpg) 47 | 48 | Here's a video of my result. 49 | 50 | [plugin:youtube](http://www.youtube.com/watch?v=qDvqUybcqwI) 51 | 52 | **And you're done!** 53 | 54 | 55 | 56 | [1]: http://audacity.sourceforge.net/ 57 | [2]: https://mp3-youtube.download 58 | [3]: http://www.jamendo.com/ 59 | -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/Sticker_img_explorer.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/02.create-a-custom-sticker/Sticker_img_explorer.jpg -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/Sticker_img_ps.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/02.create-a-custom-sticker/Sticker_img_ps.jpg -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/Sticker_img_ps2.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/02.create-a-custom-sticker/Sticker_img_ps2.jpg -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/Sticker_img_ps3.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/02.create-a-custom-sticker/Sticker_img_ps3.jpg -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/Sticker_img_ps4.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/02.create-a-custom-sticker/Sticker_img_ps4.jpg -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/Sticker_img_ps5.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/02.create-a-custom-sticker/Sticker_img_ps5.jpg -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/Sticker_img_ps6.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/02.create-a-custom-sticker/Sticker_img_ps6.jpg -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/Sticker_img_ps7.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/02.create-a-custom-sticker/Sticker_img_ps7.jpg -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/Sticker_img_ps8.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/02.create-a-custom-sticker/Sticker_img_ps8.jpg -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/Sticker_result.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/02.create-a-custom-sticker/Sticker_result.jpg -------------------------------------------------------------------------------- /03.customization/02.create-a-custom-sticker/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Create a custom sticker' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: docs 8 | --- 9 | 10 | You will need: 11 | 12 | * An image that you want to use as a sticker 13 | * Photoshop 14 | * NVIDIA Plugin for Photoshop 15 | 16 | Alternatively you can use [GIMP][1] and [this plugin][2] but it's not covered in this tutorial. 17 | 18 | First, download the [NVIDIA Plugin][3] and install it. 19 | 20 | Open Photoshop and open the image you want to use as a sticker. For this tutorial, I will be using this image of Snoop Dogg. 21 | 22 | ![](Sticker_img_ps.jpg) 23 | 24 | Create a new layer. Then select your entire image (CTRL + A), cut it (CTRL + X) and paste it (CTRL + V) on to the new layer. Delete the empty background layer. 25 | 26 | ![](Sticker_img_ps2.jpg) 27 | 28 | Click `Image` -> `Canvas Size...` (ALT + CTRL + C). Select Percent in the drop down menu, change both values to 110 and press `OK`. Sometimes if your image comes too close to the edge of your canvas, it will bleed colours when you apply the sticker to a car. 29 | 30 | ![](Sticker_img_ps3.jpg) 31 | 32 | Now it's time to add a background. Create a new layer and fill it with a colour that doesn't match your image. I normally use black here but considering that my image of Snoop Dogg is pretty dark (inb4 racets), I'll be using purple. Drag this layer under your image layer. 33 | 34 | ![](Sticker_img_ps4.jpg) 35 | 36 | Now for the alpha channel. Hold CTRL and left click on the thumbnail of the layer your image is on. Then click on the Channels tab above the layers. 37 | 38 | ![](Sticker_img_ps5.jpg) 39 | 40 | Now for the alpha channel. Hold CTRL and left click on the thumbnail of the layer your image is on. Then click on the Channels tab above the layers. Usually, Photoshop will create an alpha channel automatically but if you don't see an Alpha 1 channel here, keep reading. 41 | With your image still selected, click on the Create a new Channel button (bottom-right, beside a trashcan). Then, fill the selection on this channel with white. The white area determines which parts of the image are shown, you have to be careful with this when using more complex image shapes. 42 | 43 | ![](Sticker_img_ps6.jpg) 44 | 45 | Now it's time to prepare to save the file. If you used the default directories when installing Trackmania 2, open your documents folder and browse to `ManiaPlanet\Media\Painter`. Now create a folder named Stickers and inside that folder, create another folder and name it after your image. I'll be naming my folder SnoopDogg. As you can see, I have a few stickers already. 46 | 47 | ![](Sticker_img_explorer.jpg) 48 | 49 | Switch back to Photoshop, then click on the Layers tab and click your image layer. Now click `File` -> `Save as...` and browse to that folder you just created. Then select Targa (.tga) from the Format drop down list and name your file Sticker. 50 | **It must be named Sticker, otherwise it will not work.** Press save and then press OK when the Targa Options pop up appears, you don't need to change anything. 51 | 52 | ![](Sticker_img_ps7.jpg) 53 | 54 | Final step, making the icon. Click `Image` -> `Image Size...` (ALT + CTRL + I) and change both Pixel Dimensions to 64. Then select `File` -> `Save as...` and browse to that same folder as before. Select `D3D/DDS` (.dds) from the Format drop down list and name your file Icon. 55 | **As before, it must be named Icon, otherwise it will not work.** Click save and the NVIDIA Plugin pop up will appear, make sure it is set to DXT1 RGB 4 bpp | no alpha (it's the first option in the drop down list) and do not change anything else, just click `Save`. 56 | 57 | ![](Sticker_img_ps8.jpg) 58 | 59 | Now open Trackmania², select `Editors` -> `Paint` a car and select a car to paint. Then click on the Stickers button and browse through the Stickers using the arrows on the left until you find your custom sticker. Then slap some on the car. 60 | 61 | ![](Sticker_result.jpg) 62 | 63 | **And you're done!** 64 | 65 | 66 | 67 | [1]: http://www.gimp.org/ 68 | [2]: http://code.google.com/p/gimp-dds/ 69 | [3]: http://developer.nvidia.com/nvidia-texture-tools-adobe-photoshop#downloads 70 | -------------------------------------------------------------------------------- /03.customization/03.create-an-emblem/Emblem_SaveSettings.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/03.create-an-emblem/Emblem_SaveSettings.png -------------------------------------------------------------------------------- /03.customization/03.create-an-emblem/Emblem_Template.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/03.create-an-emblem/Emblem_Template.png -------------------------------------------------------------------------------- /03.customization/03.create-an-emblem/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Create an emblem' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: docs 8 | --- 9 | 10 | >>>>>> Tutorial from **Bonfi96** from the Maniaplanet forums 11 | 12 | # Create your emblem # 13 | On this tutorial, ***Gimp*** is used to edit an emblem. You can download it [on gimp.org][1], it's free. 14 | 15 | The template to create an emblem for the Shootmania shield is available [**here**][2]. 16 | [](Emblem_Template.png) 17 | 18 | Open the template, select the "Team image" layer and place the picture your want here. 19 | 20 | # Save correctly your emblem # 21 | 22 | In gimp, DDS is not avaiable directly, you have to install the [GIMP-DDS][4] plugin in GIMP. It's only a matter of copying one file. 23 | 24 | How to correctly save the file to have the image visible ingame (save it with the `.dds` filetype): 25 | 26 | * 512x512 27 | * BC1/DXT1 28 | * no alpha 29 | * with mipmaps 30 | 31 | ![](Emblem_SaveSettings.png) 32 | 33 | # Make your emblem visible ingame # 34 | 35 | To display your emblem in ShootMania, read [**this thread**][4] 36 | 37 | [1]: http://www.gimp.org/ 38 | [2]: ./Emblem_Template.png 39 | [3]: https://code.google.com/p/gimp-dds/ 40 | [4]: http://forum.maniaplanet.com/viewtopic.php?f=471&t=27906&p=217394#p217394 41 | -------------------------------------------------------------------------------- /03.customization/04.create-a-player-skin/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Create a player skin' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: docs 8 | --- 9 | 10 | >>>>>> Tutorial from **iyumichan** from the Maniaplanet forums 11 | 12 | # Getting Started 13 | 14 | First you will need a program able to edit or convert dds images. 15 | 16 | There are 3 possible tools that I know off: 17 | 18 | Directly Editing: 19 | [Gimp][1] + [Gimp DDS Plugin][2] (Free) 20 | [Adobe Photoshop][3] (Not free) + [Nvidia Texture Tools Plugin][4] (free) 21 | 22 | Converting and viewing: 23 | [DXTbmp][5] (Free) 24 | 25 | 26 | # Getting the Playerdata 27 | 28 | You can get the default StormMan Data from here: `C:\ProgramData\ManiaPlanet\PacksCache\ShootMania.zip\ShootMania\Items\Characters\ArenaPlayerDefaultSkin.zip` 29 | Driveletter might differ! 30 | 31 | Now that you have this file unpack it into a folder. 32 | 33 | 34 | # Data Explained 35 | What you are now seeing are the textures and meshes of the default player. 36 | 37 | **Icon.dds** 38 | This is the icon you see in player selection. 39 | 40 | **Diffuse.dds** 41 | This is the texture you normally see ingame. Heres the face and armor of the player. 42 | 43 | **Normal.dds** 44 | This is basically a hightmap for the Diffuse.dds I recommend generating a new one if you edited Diffuse.dds 45 | 46 | **Energy.dds** 47 | This contains the glowing parts of the armor. If you want the head of the player to glow purple then you would need to paint the place where the face in diffuse.dds is purple in Energy.dds 48 | 49 | **Specular.dds** 50 | Defines shininess and highlight colour. Same size as Diffuse.dds and everything is at the same place. 51 | 52 | **TeamMask.dds** 53 | This defines which parts are teamcolored or colored with your set trailcolor. Same size as Diffuse.dds and everything is in the same place. 54 | 55 | **Player.anim.gbx** 56 | Contains Player Animations. 57 | 58 | **Player_1.Solid2.gbx** 59 | Contains Player Model. 60 | 61 | **Horn.wav** 62 | The default horn sound for this skin. (which can be overriden in the profile menu in-game) 63 | 64 | **Sound\** 65 | Replicate (part of) the contents of `ShootMania\Media\Audio\Sound\Character\Man\` (included in `C:\ProgramData\ManiaPlanet\PacksCache\ShootMania.zip`) and override the sounds as you like for your skin. 66 | 67 | 68 | # Packing the things up 69 | Once you're done with your edits you probably want to see this ingame. To have this ingame you will need to pack the files I listed before into a zip archive. When you zip it the most important thing is that the archive should not contain any folders. Besides that the only thing worth to mention is that the zip archive name (excluding .zip) will be the name of your skin that is shown ingame. 70 | 71 | You can use the following programs to zip your files: 72 | * [7zip][6] 73 | * [WinRAR][7] 74 | 75 | 76 | # Moving it Ingame 77 | Get your zip and move it to `username/my documents/maniaplanet/skins/vehicles/arenaplayer/` 78 | Once you got the zip there go ingame and start shootmania. 79 | 80 | Go to Profile and then Models. Select your skin and when exiting the profile answer yes to "apply changes". Once you are going online you will be asked if you take responsibility for the skin you are using. 81 | At this point remember that you don't steal images or characters made by other people. Breaking a copyright is a crime. If you wish to use stuff other people created in your skin then you will have to ask them. 82 | 83 | 84 | # Share Your Skin 85 | You can share your skin easily with [Maniapark][8], which has a dedicated section (Shootmania => Skins). 86 | 87 | Once you have your skin somewhere online you will have to ensure that other players also see it and therefore you will have to create a locator file. Create an empty txt file and open it. Enter the link to your uploaded skin (for example [http://the-team-mystery.com/tm2/JokerMan.zip](#)) Now save the file and rename the txt file to the same name as your zip file plus adding the .loc ending. So if your file is called mycoolskin.zip then you name your locatorfile mycoolskin.zip.loc 88 | 89 | Now you only have to move that loc file into the same directory you put your skin file. If you don't remember it then here it is again: `username/my documents/maniaplanet/skins/vehicles/arenaplayer/` 90 | 91 | If you are playing now the players will download the skin from the link you specified in the locator file ;) 92 | 93 | 94 | You are done! I hope you found this helpful and have fun being creative! 95 | 96 | ![](joker_skin.png) 97 | 98 | [1]: http://www.gimp.org/ 99 | [2]: http://code.google.com/p/gimp-dds/ 100 | [3]: http://www.adobe.com/products/photoshop.html 101 | [4]: http://developer.nvidia.com/nvidia-texture-tools-adobe-photoshop 102 | [5]: http://www.mwgfx.co.uk/programs/dxtbmp.htm 103 | [6]: https://www.7-zip.org/ 104 | [7]: https://www.win-rar.com/ 105 | [8]: http://www.maniapark.com/ 106 | -------------------------------------------------------------------------------- /03.customization/04.create-a-player-skin/joker_skin.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/04.create-a-player-skin/joker_skin.png -------------------------------------------------------------------------------- /03.customization/05.using-custom-content/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Using a custom content' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: 8 | - docs 9 | --- 10 | 11 | Once you have created or download a custom content it's normal to use it, to do it when you have the file (usually a "*.zip"), you have to place it on the following folder depending of the nature and the environment of the content: 12 | 13 | >>>>>> By default `[User Data]` is `C:\Users\***USERNAME***\Documents\ManiaPlanet` yet you can specify the location yourself when you install Maniaplanet or via the Maniaplanet Launcher (with the `Help` button). 14 | 15 | !!! **For skins & 3D models:** 16 | !!!* Trackmania² Canyon: `[User Data]/Skins/Models/CanyonCar/` 17 | !!!* Trackmania² Valley: `[User Data]/Skins/Models/ValleyCar/` 18 | !!!* Trackmania² Lagoon: `[User Data]/Skins/Models/LagoonCar/` 19 | !!!* Trackmania² Stadium: `[User Data]/Skins/Models/StadiumCar/` 20 | !!!* Shootmania Storm: `[User Data]/Skins/Models/ArenaPlayer/` 21 | 22 | !!! **For mods:** 23 | !!!* Trackmania² Canyon: `[User Data]/Skins/Canyon/Mod/` 24 | !!!* Trackmania² Valley: `[User Data]/Skins/Valley/Mod/` 25 | !!!* Trackmania² Lagoon: `[User Data]/Skins/Lagoon/Mod/` 26 | !!!* Trackmania² Stadium: `[User Data]/Skins/Stadium/Mod/` 27 | !!!* Shootmania Storm: `[User Data]/Skins/Storm/Mod/` 28 | 29 | !!! **For signs:** `[User Data]/Skins/Any/Advertisement/` 30 | 31 | !!! **For editor plugins:** `[User Data]/Scripts/Editorplugins/` 32 | -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDamage.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDamage.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDamage_alpha.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDamage_alpha.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDiffuse.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDiffuse.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDiffuse_alpha.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDiffuse_alpha.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDirty.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDirty.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDirty_alpha.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_DetailsDirty_alpha.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_DetailsIllum.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_DetailsIllum.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_DetailsIllum_alpha.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_DetailsIllum_alpha.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_FakeShad.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_FakeShad.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_Icon.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_Icon.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_Icon_alpha.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_Icon_alpha.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_ProjWheelShad.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_ProjWheelShad.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_SkinDamage.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_SkinDamage.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_SkinDamage_alpha.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_SkinDamage_alpha.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_SkinDiffuse.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_SkinDiffuse.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_SkinDiffuse_alpha.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_SkinDiffuse_alpha.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_SkinDirty.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_SkinDirty.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_SkinDirty_alpha.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_SkinDirty_alpha.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_WheelsDiffuse.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_WheelsDiffuse.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_WheelsDiffuse_alpha.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_WheelsDiffuse_alpha.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_WheelsDirty.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_WheelsDirty.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_WheelsDirty_alpha.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_WheelsDirty_alpha.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_alphasource.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_alphasource.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_cmd.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_cmd.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_copydialog.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_copydialog.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_figure1.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_figure1.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_figure2.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_figure2.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_figure3.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_figure3.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_figure4.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_figure4.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_figure5.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_figure5.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_figure6.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_figure6.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_figure7.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_figure7.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_figure8.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_figure8.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_importfolder.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_importfolder.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_pivots.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_pivots.png -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_resetxform.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_resetxform.png -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_screenshot.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_screenshot.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_skylight.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_skylight.png -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_success.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_success.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_uvafter.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_uvafter.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/carskin_uvbefore.jpg: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/carskin_uvbefore.jpg -------------------------------------------------------------------------------- /03.customization/06.importer/01.import-a-car-skin/helpers.zip: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/maniaplanet/documentation/1d0009264bc9cacd78fd6304fadfd14a89b575f5/03.customization/06.importer/01.import-a-car-skin/helpers.zip -------------------------------------------------------------------------------- /03.customization/06.importer/02.import-a-character-skin/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Import a character skin' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: docs 8 | --- 9 | 10 | Character skins can be displayed and selected by players in the profile/models menu, and the scripts can also force skins to players during gameplay. 11 | 12 | The asset files to import must be located in the folder `{maniaplanet_user_dir}/Work/Skins/Models/{name_of_the_model}/{name_of_the_skin}` 13 | For the default shootmania model (aka 'the shootman'), `{name_of_the_model}` is `ArenaPlayer` 14 | 15 | The asset files to provide are 16 | 17 | - the mesh file (.Fbx format, version 2013.3 maximum) 18 | - the textures (to place in subfolder "Texture") 19 | - the animations file(.Fbx format, version 2013.3 maximum) 20 | - the .anim.xml animation definition file 21 | - the icon (to place in a subfolder "Icon") 22 | - the sounds (optional) 23 | 24 | See Sample skin : `Work/Skins/Models/ArenaPlayer/SintelSample` (in `NadeoImporterSamples.zip`) 25 | 26 | To learn how to prepare the character mesh for import, see the dedicated page : [mesh import](../import-a-mesh) -------------------------------------------------------------------------------- /03.customization/06.importer/05.import-a-font/docs.md: -------------------------------------------------------------------------------- 1 | --- 2 | title: 'Import a font' 3 | process: 4 | markdown: true 5 | twig: true 6 | taxonomy: 7 | category: 8 | - docs 9 | --- 10 | 11 | You can import fonts from ttf and otf files. Then you will be able to use the Font.Gbx files generated by the import process in your manialinks to display labels with custom fonts. 12 | Note that players will need the Font.Gbx file to display your manialink correctly, so it is recommended that you use custom fonts only inside a title pack (which includes those font files). 13 | 14 | Importing a font is quite simple, just follow these steps 15 | 16 | 1. Place the font file in Work folder 17 | -- 18 | The font file you want to import must have the extension .ttf, .otf or .ttc. Ttf and otf are the most commonly used font formats, you can find such files very easily on the web. 19 | 20 | First you have to place this font file in a folder that we will call {FontFileFolder} and that must be {maniaplanet_user_dir}/Work/Media/Font or any subfolder you want. 21 | 22 | For example, the path of your font file could be: 23 | `C:/Users/Bob/Documents/ManiaPlanet/Work/Media/Font/times.ttf` 24 | or 25 | `C:/Users/Bob/Documents/ManiaPlanet/Work/Media/Font/FontPack1/times.ttf` 26 | 27 | 28 | 2. Create the xml file 29 | -- 30 | To import a font, you must create a .xml file describing how to import it. Create a new empty file and name it {FontName}.xml, where {FontName} is the name that will be used in manialinks. It is often a good idea to use the same name as the original font file but you don't need to. 31 | 32 | Then place this file in {XmlFileFolder}, that must be {maniaplanet_user_dir}/Work/Media/Font or any subfolder you want. It is recommended to use the same folder as {FontFileFolder}, but you can use another if you want. 33 | 34 | Finally, open the file and fill it with this single line: ``, where {FontFilePathRelativeToXmlFolder} is the complete path (with filename and extension) of the font file relative to {FontFileFolder}. You can use "../" to go to parent folder. 35 | 36 | For example: 37 | 38 | - if the path of the font file is: `C:/Users/Bob/Documents/ManiaPlanet/Work/Media/Font/times.ttf` 39 | and the path of the xml file is: `C:/Users/Bob/Documents/ManiaPlanet/Work/Media/Font/TimesNewRoman.xml` 40 | then you will write: `` 41 | 42 | - if the path of the font file is: `C:/Users/Bob/Documents/ManiaPlanet/Work/Media/Font/FontPack1/times.ttf` 43 | and the path of the xml file is: `C:/Users/Bob/Documents/ManiaPlanet/Work/Media/Font/TimesNewRoman.xml` 44 | then you will write: `` 45 | 46 | - if the path of the font file is: `C:/Users/Bob/Documents/ManiaPlanet/Work/Media/Font/times.ttf` 47 | and the path of the xml file is: `C:/Users/Bob/Documents/ManiaPlanet/Work/Media/Font/FontPack1/TimesNewRoman.xml` 48 | then you will write: `` 49 | 50 | 51 | 3. Import 52 | -- 53 | Now open a command line prompt in the `{Maniaplanet_exe_dir}` (the folder where you have unzipped the NadeoImporter) and then type the command : 54 | 55 | ``` 56 | NadeoImporter Font {XmlFileFolderPathRelativeToWorkFolder}/{FontName}.xml 57 | ``` 58 | 59 | where {XmlFileFolderPathRelativeToWorkFolder} is the path of the folder containing the xml file you have created in step 2, relative to {maniaplanet_user_dir}/Work folder. 60 | 61 | This command will create several files: 62 | 63 | - the main gbx font file: `{maniaplanet_user_dir}/{XmlFileFolderPathRelativeToWorkFolder}/{FontName}.Font.Gbx` 64 | 65 | - one or several texture files: `{maniaplanet_user_dir}/{XmlFileFolderPathRelativeToWorkFolder}/{FontName}_Textures/{FontName}_XX.dds` where XX is first 00 and increases for each new texture file 66 | 67 | For example, if the path of the xml file is: `C:/Users/Bob/Documents/ManiaPlanet/Work/Media/Font/TimesNewRoman.xml` 68 | then you will type `NadeoImporter Font Media/Font/TimesNewRoman.xml` 69 | which will create `C:/Users/Bob/Documents/ManiaPlanet/Media/Font/TimesNewRoman.Font.Gbx`, `C:/Users/Bob/Documents/ManiaPlanet/TimesNewRoman_Textures/TimesNewRoman_00.dds` and `C:/Users/Bob/Documents/ManiaPlanet/Media/Font/TimesNewRoman_Textures/TimesNewRoman_01.dds` 70 | 71 | Note: If you want to put this font in one of your title packs, do not forget to include not only the Font.Fbx files but also all the textures in the related textures directory 72 | 73 | 74 | 4. Use the font in your manialinks 75 | -- 76 | Labels have an attribute called "textfont" which enables you to use a custom font for the text to display. 77 | 78 | - if {FontName}.Font.Gbx was imported directly in the `{maniaplanet_user_dir}/Media/Font/` folder, then just add `textfont="{FontName}"` in your label tag 79 | 80 | - if {FontName}.Font.Gbx was imported in a subfolder `{maniaplanet_user_dir}/Media/Font/{SubPath}`, then add `textfont="{SubPath}/{FontName}` 81 | 82 | For example, 83 | 84 | - if the path of the gbx font file is: `C:/Users/Bob/Documents/ManiaPlanet/Media/Font/TimesNewRoman.Font.Gbx` 85 | then your label will be: `