SonicGLvl - Revision history

Dan: Added link to SonicGLvl guide for Sonic Generations

2025-04-25T22:28:10Z

Added link to SonicGLvl guide for Sonic Generations

← Older revision		Revision as of 22:28, 25 April 2025
Line 4:		Line 4:

	Its main purpose is to modify dynamic objects in a pre-existing level. To make your own level, use ''[[Hedgehog Converter]]'' to generate terrain, and ''[[Havok Converter]]'' for collision.		Its main purpose is to modify dynamic objects in a pre-existing level. To make your own level, use ''[[Hedgehog Converter]]'' to generate terrain, and ''[[Havok Converter]]'' for collision.

			For general information on how to use SonicGLvl, refer to [[How To Use Sonic GLvl with Sonic Generations\|this guide]].

	== Features ==		== Features ==

Dan: fixed MediaWiki bug where editing the page through source will destroy multiple newline characters in table entries for some reason.

2025-04-25T17:58:08Z

fixed MediaWiki bug where editing the page through source will destroy multiple newline characters in table entries for *some reason.*

Dan: Branding consistency fix (whoops)

2025-04-25T17:50:28Z

Branding consistency fix (whoops)

← Older revision		Revision as of 17:50, 25 April 2025
Line 150:		Line 150:
	<code><small><Extra type="preview_box_x" name="Collision_Width" /></small></code>		<code><small><Extra type="preview_box_x" name="Collision_Width" /></small></code>
	\|}		\|}
	Note that these extra parameters only exist to make visual feedback in ~~Sonic GLvl~~ more intuitive. They will not affect what is saved into the game's <code>setdata</code> files in any way.		Note that these extra parameters only exist to make visual feedback in SonicGLvl more intuitive. They will not affect what is saved into the game's <code>setdata</code> files in any way.

Dan: something read weird in the summary so i changed it oop

2025-04-25T17:46:56Z

something read weird in the summary so i changed it oop

← Older revision		Revision as of 17:46, 25 April 2025
Line 3:		Line 3:
	'''SonicGLvl''' is a LibGens tool for editing levels for ''[[Sonic Unleashed]]'' and ''[[Sonic Generations]]''. Developed originally to assist in the development of the ''Unleashed Project'' mod, it has been a staple of level editing for ''Generations'' mods over the years.		'''SonicGLvl''' is a LibGens tool for editing levels for ''[[Sonic Unleashed]]'' and ''[[Sonic Generations]]''. Developed originally to assist in the development of the ''Unleashed Project'' mod, it has been a staple of level editing for ''Generations'' mods over the years.

	Its main purpose is to modify dynamic objects in a pre-existing level. To make your own, use ''[[Hedgehog Converter]]'' to generate terrain, and ''[[Havok Converter]]'' for collision.		Its main purpose is to modify dynamic objects in a pre-existing level. To make your own level, use ''[[Hedgehog Converter]]'' to generate terrain, and ''[[Havok Converter]]'' for collision.

	== Features ==		== Features ==

Dan: More changes to the page, documenting object templates. This is rather large and might need its own sub-page depending on what we want.

2025-04-25T17:41:55Z

More changes to the page, documenting object templates. This is rather large and might need its own sub-page depending on what we want.

Show changes

Dan: First draft on a rewrite of the "SonicGLvl" page. Will need another pass to add more information and fix any formatting issues.

2025-04-25T02:22:13Z

First draft on a rewrite of the "SonicGLvl" page. Will need another pass to add more information and fix any formatting issues.

← Older revision		Revision as of 02:22, 25 April 2025
Line 1:		Line 1:
	{{Notice\|type=info\|content=This page is incomplete.}}{{ToolInfobox\|title=SonicGLvl\|author=DarioSamo\|website=https://github.com/DarioSamo/libgens-sonicglvl\|image=\|download=https://github.com/DarioSamo/libgens-sonicglvl/releases}}		{{Notice\|type=info\|content=This page is incomplete.}}{{ToolInfobox\|title=SonicGLvl\|author=DarioSamo\|website=https://github.com/DarioSamo/libgens-sonicglvl\|image=GLVL Logo.png\|download=https://github.com/DarioSamo/libgens-sonicglvl/releases}}

	'''SonicGLvl''' is a LibGens tool ~~that allows you to edit~~ levels ~~from~~ Sonic Unleashed and Sonic Generations.		'''SonicGLvl''' is a LibGens tool for editing levels for ''[[Sonic Unleashed]]'' and ''[[Sonic Generations]]''. Developed originally to assist in the development of the ''Unleashed Project'' mod, it has been a staple of level editing for ''Generations'' mods over the years.

			Its main purpose is to modify dynamic objects, though earlier versions supported importing terrain models into the program to convert to game formats. This functionality has since been improved on with ''[[Hedgehog Converter\|Hedgehog Converter,]]'' and ''[[Havok Converter]]'' for collision.

			== Features ==
			[[File:GLVL WindowExample.webp\|alt=An example of Jungle Joyride Act 1 (Night) in SonicGLVL, showcasing several features of the editor including game-accurate shaders, object templates, and more.\|left\|thumb\|272x272px\|The SonicGLvl main window]]
			SonicGLvl is designed to modify set object data from ''Unleashed'' and ''Generations''. As such, it offers a full 3D viewport to navigate levels with 3D manipulators for changing position and rotation data. GLvl provides object palettes of different types of objects, such as common, stage-specific, and enemy objects, and helper objects such as "SonicSpawn" which can assist in iterating on level design. Each object has a collection of parameters that can be modified with live feedback depending on the type of object. How these parameters affect what is displayed in-editor can be configured by the user on a per-object basis, through modifying its "template," which will be explained later.

			Levels in both games use "Layers" which categorize and organize objects of different types. In Generations, this is limited to a certain amount of layers that are always active (such as <code>base</code>, <code>effect</code>, <code>sound</code>, etc.), along with layers numbered <code>00</code> to <code>09</code> which can be enabled and disabled through trigger objects. In ''Unleashed,'' users can define as many layers as they want in <code>Stage.stg.xml</code>. These layers can be set as the "active layer" through the option on the bottom left of the window, titled "Current Object Set," along with a visibility toggle--for particularly large levels, this can be quite useful for removing visual noise while editing.
			[[File:GLVL MaterialEditor.webp\|alt=A view of the material editor for SonicGLVL showing an animated Sonic with game-accurate shaders.\|thumb\|SonicGLvl's material editor]]
			SonicGLvl also features a material editor, with a live preview window utilizing translated shaders from the original games to provide an accurate view of what the user's materials will look like in-game. This window also allows the user to import a skeletal mesh and preview any animation, useful when designing new designs for set objects and decorations.

			=== Object Templates ===
			[[File:GLVL ObjectTemplate.webp\|alt=An example of a SonicGLvl object template for the object "ChangeMode_3DtoForward" as seen in Sublime Text 3. \|left\|thumb\|An example of a SonicGLvl object template.]]
			SonicGLvl uses "object templates" to define dynamic objects that can be placed in the game world. These are manually defined by the user based on the object definitions in a given <code>setdata</code> XML file. Note that if SonicGLvl does not recognize an object present in a level's <code>setdata</code> files, the program will generate a default template based on the available information. This template will be incomplete, however--it will assume default values based on what it's presented in the given file, will assume all values are "floats" when some may in fact be integer values, and it will not have a model reference or support extra features such as collision previews. These features must be added manually by the user after-the-fact in order to take full advantage of the template system.

Skyth: Created page with "{{Notice|type=info|content=This page is incomplete.}}{{ToolInfobox|title=SonicGLvl|author=DarioSamo|website=https://github.com/DarioSamo/libgens-sonicglvl|image=|download=https://github.com/DarioSamo/libgens-sonicglvl/releases}} '''SonicGLvl''' is a LibGens tool that allows you to edit levels from Sonic Unleashed and Sonic Generations."

2025-04-19T18:08:08Z

Created page with "{{Notice|type=info|content=This page is incomplete.}}{{ToolInfobox|title=SonicGLvl|author=DarioSamo|website=https://github.com/DarioSamo/libgens-sonicglvl|image=|download=https://github.com/DarioSamo/libgens-sonicglvl/releases}} '''SonicGLvl''' is a LibGens tool that allows you to edit levels from Sonic Unleashed and Sonic Generations."

New page

{{Notice|type=info|content=This page is incomplete.}}{{ToolInfobox|title=SonicGLvl|author=DarioSamo|website=https://github.com/DarioSamo/libgens-sonicglvl|image=|download=https://github.com/DarioSamo/libgens-sonicglvl/releases}}

'''SonicGLvl''' is a LibGens tool that allows you to edit levels from Sonic Unleashed and Sonic Generations.

← Older revision		Revision as of 17:58, 25 April 2025
Line 109:		Line 109:
	\|<small>A string for a havok animation (or <code>.anm.hkx</code>) file from the game resources.</small>		\|<small>A string for a havok animation (or <code>.anm.hkx</code>) file from the game resources.</small>
	<small>An example would be <code>sn_idle00.anm.hkx</code>. This animation will loop perpetually.</small>		<small>An example would be <code>sn_idle00.anm.hkx</code>. This animation will loop perpetually.</small>

	<small>Note that more than one "animation" parameters can be made to change the default animation.</small>		<small>Note that more than one "animation" parameters can be made to change the default animation.</small>
	\|-		\|-
Line 118:		Line 119:
	\|<small>This property will set the scale of an object. Accepts either numerical values or a string.</small>		\|<small>This property will set the scale of an object. Accepts either numerical values or a string.</small>
	<small>The [*] should be replaced with the desired axis to be scaled.</small>		<small>The [*] should be replaced with the desired axis to be scaled.</small>


	<small>If a number is provided in the <code>name</code> field, it should be enclosed in quotation marks as if it were a string. Thus the syntax for a value of "3" in the X axis of this parameter should be written as:</small>		<small>If a number is provided in the <code>name</code> field, it should be enclosed in quotation marks as if it were a string. Thus the syntax for a value of "3" in the X axis of this parameter should be written as:</small>

	<code><small><Extra type="scale_x" name="3" /></small></code>		<code><small><Extra type="scale_x" name="3" /></small></code>


	<small>If a string is provided, it should match the name of an in-game parameter exactly. For example, the object <code>SszUpDownPole</code> uses the parameter <code>ModelLengthWidth</code> to control the X scale of the model. This syntax would be written as:</small>		<small>If a string is provided, it should match the name of an in-game parameter exactly. For example, the object <code>SszUpDownPole</code> uses the parameter <code>ModelLengthWidth</code> to control the X scale of the model. This syntax would be written as:</small>

	<code><small><Extra type="scale_x" name="ModelLengthWidth" /></small></code>		<code><small><Extra type="scale_x" name="ModelLengthWidth" /></small></code>
	\|-		\|-
Line 126:		Line 133:
	\|<small>This property will set the rotation of an object. Accepts either numerical values or a string.</small>		\|<small>This property will set the rotation of an object. Accepts either numerical values or a string.</small>
	<small>The [*] should be replaced with the desired axis to rotate along in euler angles.</small>		<small>The [*] should be replaced with the desired axis to rotate along in euler angles.</small>


	<small>If a number is provided in the <code>name</code> field, it should be enclosed in quotation marks as if it were a string. Thus the syntax for a value of "180" in the Y axis of this parameter should be written as:</small>		<small>If a number is provided in the <code>name</code> field, it should be enclosed in quotation marks as if it were a string. Thus the syntax for a value of "180" in the Y axis of this parameter should be written as:</small>

	<code><small><Extra type="offset_rotation_y" name="180" /></small></code>		<code><small><Extra type="offset_rotation_y" name="180" /></small></code>


	<small>If a string is provided, it should match the name of an in-game parameter exactly. For example, if an object had a parameter labeled <code>Twist</code> to control the Z rotation of the model, that syntax would be written as:</small>		<small>If a string is provided, it should match the name of an in-game parameter exactly. For example, if an object had a parameter labeled <code>Twist</code> to control the Z rotation of the model, that syntax would be written as:</small>

	<code><small><Extra type="offset_rotation_z" name="Twist" /></small></code>		<code><small><Extra type="offset_rotation_z" name="Twist" /></small></code>
	\|-		\|-
Line 137:		Line 150:
	\|<small>This property will set the rotation of an object '''''over time'''''. Accepts either numerical values or a string.</small>		\|<small>This property will set the rotation of an object '''''over time'''''. Accepts either numerical values or a string.</small>
	<small>The [*] should be replaced with the desired axis to rotate along in euler angles.</small>		<small>The [*] should be replaced with the desired axis to rotate along in euler angles.</small>


	<small>If a number is provided in the <code>name</code> field, it should be enclosed in quotation marks as if it were a string. Thus the syntax for a value of "120" units per second for the Y axis of this parameter should be written as:</small>		<small>If a number is provided in the <code>name</code> field, it should be enclosed in quotation marks as if it were a string. Thus the syntax for a value of "120" units per second for the Y axis of this parameter should be written as:</small>

	<code><small><Extra type="offset_rotation_y_speed" name="120" /></small></code>		<code><small><Extra type="offset_rotation_y_speed" name="120" /></small></code>


	<small>If a string is provided, it should match the name of an in-game parameter exactly. For example, if an object had a parameter labeled <code>TwistSpeed</code> to control its Z rotation over time, that syntax would be written as:</small>		<small>If a string is provided, it should match the name of an in-game parameter exactly. For example, if an object had a parameter labeled <code>TwistSpeed</code> to control its Z rotation over time, that syntax would be written as:</small>

	<code><small><Extra type="offset_rotation_z_speed" name="TwistSpeed" /></small></code>		<code><small><Extra type="offset_rotation_z_speed" name="TwistSpeed" /></small></code>
	\|-		\|-
Line 145:		Line 164:
	\|<small>This property will set the scale of a transparent box when selected. Useful for objects that have collision volumes, such as <code>ChangeVolumeCamera</code>. Accepts either numerical values or a string.</small>		\|<small>This property will set the scale of a transparent box when selected. Useful for objects that have collision volumes, such as <code>ChangeVolumeCamera</code>. Accepts either numerical values or a string.</small>
	<small>The [*] should be replaced with the desired axis to scale the preview box.</small>		<small>The [*] should be replaced with the desired axis to scale the preview box.</small>

	<small>If a number is provided in the <code>name</code> field, it should be enclosed in quotation marks as if it were a string. Thus the syntax for a value of "1" in the Z axis of this parameter should be written as:</small>		<small>If a number is provided in the <code>name</code> field, it should be enclosed in quotation marks as if it were a string. Thus the syntax for a value of "1" in the Z axis of this parameter should be written as:</small>

	<code><small><Extra type="scale_z" name="1" /></small></code>		<code><small><Extra type="scale_z" name="1" /></small></code>


	<small>If a string is provided, it should match the name of an in-game parameter exactly. For example, the object <code>ChangeVolumeCamera</code> uses the parameter <code>Collision_Width</code> to control the X scale of the collider. This syntax would be written as:</small>		<small>If a string is provided, it should match the name of an in-game parameter exactly. For example, the object <code>ChangeVolumeCamera</code> uses the parameter <code>Collision_Width</code> to control the X scale of the collider. This syntax would be written as:</small>

	<code><small><Extra type="preview_box_x" name="Collision_Width" /></small></code>		<code><small><Extra type="preview_box_x" name="Collision_Width" /></small></code>
	\|}		\|}
	Note that these extra parameters only exist to make visual feedback in SonicGLvl more intuitive. They will not affect what is saved into the game's <code>setdata</code> files in any way.		Note that these extra parameters only exist to make visual feedback in SonicGLvl more intuitive. They will not affect what is saved into the game's <code>setdata</code> files in any way.