Difference between revisions of "KMP3D"

From Custom Mario Kart
Jump to navigation Jump to search
Line 14: Line 14:
 
|-
 
|-
 
! File Formats:
 
! File Formats:
| [[KMP]]
+
| [[KMP]], [[KCL]]
 
|-
 
|-
 
! Current Version:
 
! Current Version:
| v5.0
+
| v5.1
 
|-
 
|-
 
! Date of Latest Version:
 
! Date of Latest Version:
| 2019-11-25
+
| 2019-12-1
 
|-
 
|-
 
! Download:
 
! Download:
Line 47: Line 47:
 
# Rename the .rbz extension to .zip.
 
# 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.
 
# 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 History ==
Line 102: Line 117:
 
* Can now directly export to KMPs, rather than WKMPT.
 
* Can now directly export to KMPs, rather than WKMPT.
 
* Now utilizes SketchUp layers to hide points from other sections.
 
* 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-1
 +
|
 +
* Added Import KCL feature.
 +
* Added AREAs.
 +
* Fixed various GOBJ placement errors.
 +
* Fixed various compatibility issues.
 +
* Improved group editing, allowing whole groups to be selected.
 
|}
 
|}
  
 
{{User-Zatchi-Link}}
 
{{User-Zatchi-Link}}
 
[[Category:Software]]
 
[[Category:Software]]

Revision as of 12:34, 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-1
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-1
  • 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