Difference between revisions of "KMP3D"

From Custom Mario Kart
Jump to navigation Jump to search
m
(40 intermediate revisions by 6 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:
−
| To be updated
+
| v5.1
 +
|-
 +
! Date of Latest Version:
 +
| 2019-12-01
 
|-
 
|-
 
! Download:
 
! Download:
−
| To be updated
+
| [https://github.com/zach-zajack/kmp3d/releases GitHub]
 
|}
 
|}
−
'''KMP3D''' is a plugin for [[Google SketchUp]] 6 and above that turns text placed on the model into 3D points in the model, or lines for checkpoints.
 
−
==How To Use==
 
−
* Install by putting the .rbz file into SketchUp's program files. Put this in the Tools folder.
 
−
* Activate tool by using the GUI buttons in the toolbar. One is for single points (e.g. enemy points), another is for dual (e.g. checkpoints). Information about the type and its settings are listed below. Defaulted to 0, 1, or 25, depending on the setting.
 
  
−
Each setting is separated by a comma; parentheses and spaces are optional.
+
== 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 ==
 +
[[File:KMP3D-InModel-Preview.png|400px]]
 +
 
 +
== 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.
 +
 
 +
== 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 ==
 
{| class="wikitable"
 
{| class="wikitable"
 +
! Version
 +
! Date of release
 +
! Information
 
|-
 
|-
−
! Type
+
| v1.0
−
! Name
+
| 2016-09-31
−
! colspan=5 | Settings
+
| First release
−
|-
 
−
| Area (AREA)
 
−
| A
 
−
| Scale
 
−
| Rotation
 
−
| -
 
−
| -
 
−
| -
 
 
|-
 
|-
−
| Checkpoint (CKPT)
+
| v2.0
−
| C
+
| 2017-01-15
−
| Current Group
+
|
−
| Next Group
+
* Remade the entire interface.
−
| Respawn
+
* Added ability to edit multiple points.
−
| Key
+
* Added ability to import objects.
−
| -
+
* Added ability to rotate/scale points with a tool.
 
|-
 
|-
−
| Cannon (CNPT)
+
| [https://www.dropbox.com/s/lhjx16kojggljf9 v3.0]
−
| N
+
| 2017-07-03
−
| Rotation
+
|
−
| -
+
* 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.
 
|-
 
|-
−
| CPU (ENPT)
+
| [https://github.com/zach-zajack/kmp3d/releases/download/v4.0/KMP3D.rbz v4.0]
−
| E
+
| 2019-11-03
−
| Current Group
+
|
−
| Next Group
+
* Remade the entire interface.
−
| Scale
+
* Fixed compatibility issues.
−
| Setting 1
 
−
| Setting 2
 
 
|-
 
|-
−
| Objects (GOBJ)
+
| [https://github.com/zach-zajack/kmp3d/releases/download/v4.1/KMP3D.rbz v4.1]
−
| O
+
| 2019-11-06
−
| Object ID (decimal)
+
|
−
| Route
+
* Changed default value to 1.0 for the Speed Modifier setting in the Stage Info.
−
| Rotation
+
* Fixed WKMPT exporting errors for Stage Info settings.
−
| Scale
 
−
| Settings 1...8
 
 
|-
 
|-
−
| Item (ITPT)
+
| [https://github.com/zach-zajack/kmp3d/releases/download/v4.2/KMP3D.rbz v4.2]
−
| E
+
| 2019-11-09
−
| Current Group
+
|
−
| Next Group
+
* Added point hybridization feature.
−
| Scale
+
* Model updates when points are combined.
−
| Setting 1
+
* Updated CSS interface.
−
| Setting 2
+
* Added dropdown menus and checkboxes for settings.
 +
* More specific limitations on settings.
 +
* Fixed various bugs for exporting WKMPT files.
 
|-
 
|-
−
| Respawn (JGPT)
+
| [https://github.com/zach-zajack/kmp3d/releases/download/v5.0/KMP3D.rbz v5.0]
−
| R
+
| 2019-11-25
−
| Rotation
+
|
−
| -
+
* Added "Import KMP" feature.
−
| -
+
* Can now directly export to KMPs, rather than WKMPT.
−
| -
+
* Now utilizes SketchUp layers to hide points from other sections.
−
| -
 
 
|-
 
|-
−
| Routes (POTI)
+
| [https://github.com/zach-zajack/kmp3d/releases/download/v5.1/KMP3D.rbz v5.1]
−
| P
+
| 2019-12-01
−
| Route ID
+
|
−
| -
+
* 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.
 
|}
 
|}
−
For example, if you want Enemy Points in Group 1 with the next Group being 2, it would look like this:
 
−
[[File:KMP3D-HowTo-EnemyPoint.png|900px]]
 
  
−
You can also combine multiple points under one text. For example, if you want "E(1,2)" and "I(1,2)" under the same point, you can have it as "E(1,2)I(1,2)".
+
{{User-Zatchi-Link}}
 +
[[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"