Difference between revisions of "KMP3D"

From Custom Mario Kart
Jump to navigation Jump to search
m
(17 intermediate revisions by 4 users not shown)
Line 2: Line 2:
 
|+ KMP3D
 
|+ KMP3D
 
! Author:
 
! Author:
−
| [[SpacePenguin1804]]
+
| [[zatchi]]
 
|-
 
|-
 
! Platform:
 
! Platform:
−
| [[Google SketchUp]] 6+
+
| [[SketchUp]] 6+
 
|-
 
|-
 
! Programming language:
 
! Programming language:
Line 14: Line 14:
 
|-
 
|-
 
! File Formats:
 
! File Formats:
−
| [[Wiimms SZS Tools]]' textual representation of [[KMP]].
+
| [[KMP]], [[KCL]]
 
|-
 
|-
 
! Current Version:
 
! Current Version:
−
| v3.0
+
| v5.1
 +
|-
 +
! Date of Latest Version:
 +
| 2019-12-01
 
|-
 
|-
 
! Download:
 
! Download:
−
| [https://www.dropbox.com/s/lhjx16kojggljf9/KMP3D.zip Dropbox]
+
| [https://github.com/zach-zajack/kmp3d/releases GitHub]
 
|}
 
|}
  
−
== KMP3D ==
+
== Overview ==
−
 
+
'''KMP3D''' is a [[SketchUp]] plugin made by [[zatchi]] that functions as a 3D interface for [[Mario Kart Wii]]'s [[KMP]] files, which deal with coordinate information, such as check points, item routes or respawn point positions. Points are represented using spheres and vectors, depending on the point type.
−
[[File:KMP3D-InModel-Preview.png|800px]]
 
−
 
 
−
=== About ===
 
−
'''KMP3D''' is a plugin for [[Google SketchUp]] versions 6 and above that is a 3D interface for KMP files. It uses objects like spheres and arrows to represent points.
 
  
−
It can get KMPs done in around less than an hour easily.
+
=== Credits ===
 +
* [[Beaglebark413]], for the item box model used as a placeholder for other objects.
  
−
=== Open Source Policy ===
+
== Media ==
−
If you're interested in modifying the code for KMP3D, please contact the author [[SpacePenguin1804]] before updating to this page. The source code is directly in the download, ready for modification.
+
[[File:KMP3D-InModel-Preview.png|400px]]
  
 
== Installation ==
 
== Installation ==
 +
'''Note''': If you have a previous version of KMP3D (v3.0 or lower), make sure to disable/uninstall the old extension before installing a newer version. Failure to do so will result in a loading error.
 +
=== For SketchUp 2013-2016 ===
 +
# Download the .rbz file.
 +
# In SketchUp, go to Window -> Preferences -> Extensions -> Install Extension..., and select the file.
 +
=== For SketchUp 2017+ ===
 +
# Download the .rbz file.
 +
# In SketchUp, go to Window -> Extension Manager -> Install Extension..., and select the file.
 +
=== For SketchUp 6-8 ===
 +
# Download the .rbz file.
 +
# Rename the .rbz extension to .zip.
 +
# Extract the contents of the folder into the Plugins folder in SketchUp's Program Files for Windows, or Applications folder for Mac.
  
−
* Install by extracting the zip file to SketchUp's program files (Program Files on Windows, Applications on Mac), under the folder "ShippedExtensions", "Plugins", "Tools", or something similar, depending on the version you're using.
+
== Tutorial ==
−
* Two buttons should appear: One to add points, one to edit points.
+
=== Adding and editing points ===
−
* Tutorial for KMP3D usage is below.
+
* Activate the tool and click anywhere on the model to place points. In the case of vectors and checkpoints, additional steps are required to correctly place the orientation.
 +
* Editing settings can be done through editing the table. Toggling the selection of points can be done by selecting the ID number on the row for the point.
 +
* Points can also be removed by clicking the "x" on the end of the table.
  
−
== Arguments Table ==
+
=== Group editing ===
 +
* Groups can be edited, selected, and deleted like points under the Group Settings tab.
 +
* Certain settings, such as Next Group(s) (found in [[ENPH]], [[ITPH]], and [[CKPH]]), are comma-separated lists of IDs to the next group.
 +
* [[Object]] types are also treated like groups, with each group setting denoting the object's ID. Changing the value will also update the model for points within that group.
  
−
All arguments use decimal (as opposed to hexadecimal), including Object IDs.
+
=== Importing and exporting ===
 +
* Go under Plugins (or Extensions, depending on the version) -> KMP3D. This is where you will find the options to import and export KMP files, as well as import [[KCL]] files.
 +
* For importing KMPs, make sure to activate the tool to view the points, as everything is hidden by default.
  
−
=== Table ===
 
−
{| class="wikitable"
 
−
|-
 
−
! Point Name
 
−
! colspan=10 | Settings (In Order)
 
−
|-
 
−
| Checkpoint (CKPT)
 
−
| Current Group*
 
−
| Next Group*
 
−
| Key Type (0 = not key, 1 = key)
 
−
| Respawn ID
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
|-
 
−
| CNPT (CNPT)
 
−
| Shoot Effect
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
|-
 
−
| CPU (ENPT)
 
−
| Current Group*
 
−
| Next Group*
 
−
| Scale
 
−
| Setting 1
 
−
| Setting 2
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
|-
 
−
| Objects (GOBJ)
 
−
| Object ID*
 
−
| Route
 
−
| Setting 1
 
−
| Setting 2
 
−
| Setting 3
 
−
| Setting 4
 
−
| Setting 5
 
−
| Setting 6
 
−
| Setting 7
 
−
| Setting 8
 
−
|-
 
−
| Item (ITPT)
 
−
| Current Group*
 
−
| Next Group*
 
−
| Scale
 
−
| Setting 1
 
−
| Setting 2
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
|-
 
−
| Respawn (JGPT)
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
|-
 
−
| Start (KTPT)
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
|-
 
−
| Routes (POTI)
 
−
| Route  ID Number*
 
−
| Smooth Motion (0 or 1)
 
−
| Rotation Type (0 or 1)
 
−
| Speed
 
−
| Setting 1
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
| -
 
−
|}
 
−
 
−
=== Table Usage and Syntax ===
 
−
* Anything followed by an asterisk is a required setting, and will result in an error when exporting otherwise.
 
−
* For example, if you want Enemy Points in Group 1 with the next being Group 2, it would say "ENPT(1,2)"
 
−
* If you want a group leading to a split path, it would be ENPT(1,2&3).
 
−
* To rotate points, you can use the the rotate tool that comes with SketchUp. This is the same with scaling for GOBJ and CKPT. Scale is a setting for ENPT and ITPT, however.
 
−
* You can also combine multiple points under one text. For example, if you want "ENPT(1,2)" and "ITPT(1,2)" under the same point, you can have it as "ENPT(1,2) ITPT(1,2)".
 
−
 
−
== Tutorial ==
 
−
 
−
=== Adding Points ===
 
−
* You can add points by clicking the first of the two new icons: the arrow with the plus sign. You can add points with the settings you specify in the dialog that is opened.
 
−
* Each point type has varying settings, and can be found in the Arguments Table listed above, and more info is listed below the table.
 
−
* You can add most points by simply clicking in the area you want them to be placed, with a few exceptions:
 
−
'''CKPT''': First and second clicks are the start/end of the checkpoint line. The third click specifies which way the checkpoint arrow is facing on the line.
 
−
 
−
'''CNPT''': The first click is the starting position of the cannon, whereas the ending point is the ending of the cannon. The y rotation is automatically calculated.
 
−
* If you want to change the settings for the next point you will add, simply change what is in the dialog.
 
−
=== Editing Points ===
 
−
* If you want to edit pre-existing points, you can highlight them and then press the second of the two icons: the arrow with the gear.
 
−
* The dialog that pops up will rename all of the points selected, so be careful. If nothing is entered, the points will be deleted.
 
−
* The points will automatically change to the correct shape when entered.
 
−
=== Exporting Points ===
 
−
* To export, simply go under Plugins (or Extensions, depending on version) -> KMP3D -> Export.
 
−
* Select a place to save the file to.
 
−
* Select how many laps the track will be.
 
−
* In order to convert the newly created txt file to a KMP, you will have to use [[Wiimms SZS Tools]].
 
−
* Everything will then be exported in the order placed down.
 
−
=== Importing Points ===
 
−
* To export, simply go under Plugins (or Extensions, depending on version) -> KMP3D -> Import.
 
−
* Select the txt file you will import.
 
−
* If you only have a KMP, you will have to use [[Wiimms SZS Tools]] to convert it from a KMP to a txt file.
 
−
* The program will then ask what point types you want to import. For example, if you wanted to import the ENPTs, JGPTs, GOBJs, and CKPTs, you would type "ENPT JGPT GOBJ CKPT".
 
−
* You are now free to edit the points.
 
 
== Version History ==
 
== Version History ==
 
{| class="wikitable"
 
{| class="wikitable"
−
|-
+
! Version
−
! align=left| Version
+
! Date of release
−
! align=left| Date of release
+
! Information
−
! align=left| Information
 
 
|-
 
|-
 
| v1.0
 
| v1.0
Line 194: Line 75:
 
| v2.0
 
| v2.0
 
| 2017-01-15
 
| 2017-01-15
−
| Entire interface redone.
+
|
−
* Ability to edit multiple points
+
* Remade the entire interface.
−
* Ability to import objects
+
* Added ability to edit multiple points.
−
* Ability to rotate/scale points with a tool.
+
* Added ability to import objects.
 +
* Added ability to rotate/scale points with a tool.
 
|-
 
|-
−
| v3.0
+
| [https://www.dropbox.com/s/lhjx16kojggljf9 v3.0]
 
| 2017-07-03
 
| 2017-07-03
−
| Improved interface.
+
|
−
* Ability to import points from textual representation of a KMP.
+
* Improved interface.
−
* The Add Point input box can be changed while in use.
+
* The "Add Point" input box can be changed while in use.
−
* Canon points can be added.
+
* Added ability to create cannon points and check points.
−
* Checkpoints can be added.
+
* Fixed export and edit bugs.
−
* Export and Edit bugs fixed.
+
|-
 +
| [https://github.com/zach-zajack/kmp3d/releases/download/v4.0/KMP3D.rbz v4.0]
 +
| 2019-11-03
 +
|
 +
* Remade the entire interface.
 +
* Fixed compatibility issues.
 +
|-
 +
| [https://github.com/zach-zajack/kmp3d/releases/download/v4.1/KMP3D.rbz v4.1]
 +
| 2019-11-06
 +
|
 +
* Changed default value to 1.0 for the Speed Modifier setting in the Stage Info.
 +
* Fixed WKMPT exporting errors for Stage Info settings.
 +
|-
 +
| [https://github.com/zach-zajack/kmp3d/releases/download/v4.2/KMP3D.rbz v4.2]
 +
| 2019-11-09
 +
|
 +
* Added point hybridization feature.
 +
* Model updates when points are combined.
 +
* Updated CSS interface.
 +
* Added dropdown menus and checkboxes for settings.
 +
* More specific limitations on settings.
 +
* Fixed various bugs for exporting WKMPT files.
 +
|-
 +
| [https://github.com/zach-zajack/kmp3d/releases/download/v5.0/KMP3D.rbz v5.0]
 +
| 2019-11-25
 +
|
 +
* Added "Import KMP" feature.
 +
* Can now directly export to KMPs, rather than WKMPT.
 +
* Now utilizes SketchUp layers to hide points from other sections.
 +
|-
 +
| [https://github.com/zach-zajack/kmp3d/releases/download/v5.1/KMP3D.rbz v5.1]
 +
| 2019-12-01
 +
|
 +
* Added "Import [[KCL]]" feature.
 +
* Added [[AREA]]s.
 +
* Fixed various [[GOBJ]] placement errors.
 +
* Fixed various compatibility issues.
 +
* Improved group editing, allowing whole groups to be selected.
 
|}
 
|}
  
−
== Future Plans ==
+
{{User-Zatchi-Link}}
−
These may or may not be added, but it will be attempted in future updates of the program.
 
−
* Add cameras, and a way to play them in SketchUp.
 
−
* Add AREAs.
 
−
* Have an interface capable of displaying a 2D map of the points and being able to reorder them.
 
−
* Add a wildcard option for the Edit dialog.
 
−
 
 
−
{{User-SpacePenguin1804-Link}}
 
 
[[Category:Software]]
 
[[Category:Software]]

Revision as of 17:19, 1 December 2019

KMP3D
Author: zatchi
Platform: SketchUp 6+
Programming language: Ruby
Software Type: SketchUp Plugin
File Formats: KMP, KCL
Current Version: v5.1
Date of Latest Version: 2019-12-01
Download: GitHub

Overview

KMP3D is a SketchUp plugin made by zatchi that functions as a 3D interface for Mario Kart Wii's KMP files, which deal with coordinate information, such as check points, item routes or respawn point positions. Points are represented using spheres and vectors, depending on the point type.

Credits

  • Beaglebark413, for the item box model used as a placeholder for other objects.

Media

KMP3D-InModel-Preview.png

Installation

Note: If you have a previous version of KMP3D (v3.0 or lower), make sure to disable/uninstall the old extension before installing a newer version. Failure to do so will result in a loading error.

For SketchUp 2013-2016

  1. Download the .rbz file.
  2. In SketchUp, go to Window -> Preferences -> Extensions -> Install Extension..., and select the file.

For SketchUp 2017+

  1. Download the .rbz file.
  2. In SketchUp, go to Window -> Extension Manager -> Install Extension..., and select the file.

For SketchUp 6-8

  1. Download the .rbz file.
  2. Rename the .rbz extension to .zip.
  3. Extract the contents of the folder into the Plugins folder in SketchUp's Program Files for Windows, or Applications folder for Mac.

Tutorial

Adding and editing points

  • Activate the tool and click anywhere on the model to place points. In the case of vectors and checkpoints, additional steps are required to correctly place the orientation.
  • Editing settings can be done through editing the table. Toggling the selection of points can be done by selecting the ID number on the row for the point.
  • Points can also be removed by clicking the "x" on the end of the table.

Group editing

  • Groups can be edited, selected, and deleted like points under the Group Settings tab.
  • Certain settings, such as Next Group(s) (found in ENPH, ITPH, and CKPH), are comma-separated lists of IDs to the next group.
  • Object types are also treated like groups, with each group setting denoting the object's ID. Changing the value will also update the model for points within that group.

Importing and exporting

  • Go under Plugins (or Extensions, depending on the version) -> KMP3D. This is where you will find the options to import and export KMP files, as well as import KCL files.
  • For importing KMPs, make sure to activate the tool to view the points, as everything is hidden by default.

Version History

Version Date of release Information
v1.0 2016-09-31 First release
v2.0 2017-01-15
  • Remade the entire interface.
  • Added ability to edit multiple points.
  • Added ability to import objects.
  • Added ability to rotate/scale points with a tool.
v3.0 2017-07-03
  • Improved interface.
  • The "Add Point" input box can be changed while in use.
  • Added ability to create cannon points and check points.
  • Fixed export and edit bugs.
v4.0 2019-11-03
  • Remade the entire interface.
  • Fixed compatibility issues.
v4.1 2019-11-06
  • Changed default value to 1.0 for the Speed Modifier setting in the Stage Info.
  • Fixed WKMPT exporting errors for Stage Info settings.
v4.2 2019-11-09
  • Added point hybridization feature.
  • Model updates when points are combined.
  • Updated CSS interface.
  • Added dropdown menus and checkboxes for settings.
  • More specific limitations on settings.
  • Fixed various bugs for exporting WKMPT files.
v5.0 2019-11-25
  • Added "Import KMP" feature.
  • Can now directly export to KMPs, rather than WKMPT.
  • Now utilizes SketchUp layers to hide points from other sections.
v5.1 2019-12-01
  • Added "Import KCL" feature.
  • Added AREAs.
  • Fixed various GOBJ placement errors.
  • Fixed various compatibility issues.
  • Improved group editing, allowing whole groups to be selected.

Template:User-Zatchi-Link

Retrieved from "https://wiki.tockdom.com/w/index.php?title=KMP3D&oldid=182723"