Kahvibreak Curation Tutorial - Revision history

Viperision: /* Testing the game */

2021-06-10T10:00:55Z

Testing the game

← Older revision		Revision as of 12:00, 10 June 2021
Line 21:		Line 21:
	** The first argument is the '''<span style="color:blue">name of the .jar</span>''' you want to load from the Games folder, simple enough.		** The first argument is the '''<span style="color:blue">name of the .jar</span>''' you want to load from the Games folder, simple enough.
	** The second and third argument are the '''<span style="color:darkred">width and height</span>'''. Some games adapt to multiple resolutions, while others require a specific one. Look for the resolution on the filename, the website you've got your JAR from or [https://media.discordapp.net/attachments/607833633759297548/720044908928303145/Resolution-reference.png assume it is one of these].		** The second and third argument are the '''<span style="color:darkred">width and height</span>'''. Some games adapt to multiple resolutions, while others require a specific one. Look for the resolution on the filename, the website you've got your JAR from or [https://media.discordapp.net/attachments/607833633759297548/720044908928303145/Resolution-reference.png assume it is one of these].
	** The fourth argument is the overall '''<span style="color:green">scale in %</span>''', in the example 200 is 200% so the 128x128 game will be shown as 256x256. ~~Use when it's more comfortable to play at a zoomed level than original~~, ~~so one doesn't need to squint at~~ the ~~game~~.		** The fourth argument is the overall '''<span style="color:green">scale in %</span>''', in the example 200 is 200% so the 128x128 game will be shown as 256x256. As of version 1.5.9 onward, the default scaling is calculated for different resolutions automatically, but this feature pretty customizable (check out <code>Software/GetScaleCfg.txt</code>).
	** The fifth argument changes what '''<span style="color:lightblack">framerate the game runs at</span>'''. Accepted vaules are 60, 30 and 15. Not including this parameter will have the framerate be infinite. You can do that; just be aware to include this if the game runs too fast. The default framerate is 30, although KEmulator is usually better at detecting what the framerate should be compared to FreeJ2ME.		** The fifth argument changes what '''<span style="color:lightblack">framerate the game runs at</span>'''. Accepted vaules are 60, 30 and 15. Not including this parameter will have the framerate be infinite. You can do that; just be aware to include this if the game runs too fast. The default framerate is 30, although KEmulator is usually better at detecting what the framerate should be compared to FreeJ2ME.

Viperision: /* Alternate versions */ Additional Applications

2021-05-29T15:12:38Z

Alternate versions: Additional Applications

← Older revision		Revision as of 17:12, 29 May 2021
Line 32:		Line 32:

	* Put in the Author Notes section the Launch Commands and names of other said versions. For example, if that Gangstar curation had two versions (say Gangstar.jar and Gangstar64x64.jar) you would use the regular Gangstar.jar in the Launch Command line and then on Author Notes include something like "64x64 version 'Gangstar64x64.jar 64 64 1200'". These alternate versions will be added manually.		* Put in the Author Notes section the Launch Commands and names of other said versions. For example, if that Gangstar curation had two versions (say Gangstar.jar and Gangstar64x64.jar) you would use the regular Gangstar.jar in the Launch Command line and then on Author Notes include something like "64x64 version 'Gangstar64x64.jar 64 64 1200'". These alternate versions will be added manually.
			**Alternatively, curators can add these additional applications themself by properly formatting indents in the Additional Applications section, like in the [https://cdn.discordapp.com/attachments/607833633759297548/846397932521783346/AsteroidZone-Example.zip Asteroid Zone example curation]:
			<pre>
			Application Path: Software\KLaunch.bat
			Launch Command: Asteroids.jar 128 128 400

			Additional Applications:
			App0:
			Heading: Launch with 208x208 Resolution
			Application Path: Software\KLaunch.bat
			Launch Command: Asteroids.jar 208 208 200
			App1:
			Heading: Launch with 240x320 Resolution
			Application Path: Software\KLaunch.bat
			Launch Command: Asteroids.jar 240 320 100
			</pre>

	Corrections, replacements and alternates to already curated games can be requested to be added in the #edits-and-changes channel.		Corrections, replacements and alternates to already curated games can be requested to be added in the #edits-and-changes channel.

Viperision at 03:14, 25 April 2021

2021-04-25T03:14:47Z

← Older revision		Revision as of 05:14, 25 April 2021
Line 22:		Line 22:
	** The second and third argument are the '''<span style="color:darkred">width and height</span>'''. Some games adapt to multiple resolutions, while others require a specific one. Look for the resolution on the filename, the website you've got your JAR from or [https://media.discordapp.net/attachments/607833633759297548/720044908928303145/Resolution-reference.png assume it is one of these].		** The second and third argument are the '''<span style="color:darkred">width and height</span>'''. Some games adapt to multiple resolutions, while others require a specific one. Look for the resolution on the filename, the website you've got your JAR from or [https://media.discordapp.net/attachments/607833633759297548/720044908928303145/Resolution-reference.png assume it is one of these].
	** The fourth argument is the overall '''<span style="color:green">scale in %</span>''', in the example 200 is 200% so the 128x128 game will be shown as 256x256. Use when it's more comfortable to play at a zoomed level than original, so one doesn't need to squint at the game.		** The fourth argument is the overall '''<span style="color:green">scale in %</span>''', in the example 200 is 200% so the 128x128 game will be shown as 256x256. Use when it's more comfortable to play at a zoomed level than original, so one doesn't need to squint at the game.
	** The fifth argument ~~is only for FreeJ2ME, it~~ changes what '''<span style="color:lightblack">framerate the game runs at</span>'''. Accepted vaules are 60, 30 and 15. Not including this parameter will have the framerate be infinite. You can do that; just be aware to include this if the game runs too fast.		** The fifth argument changes what '''<span style="color:lightblack">framerate the game runs at</span>'''. Accepted vaules are 60, 30 and 15. Not including this parameter will have the framerate be infinite. You can do that; just be aware to include this if the game runs too fast. The default framerate is 30, although KEmulator is usually better at detecting what the framerate should be compared to FreeJ2ME.
	*** This setting does not effect KEmulator and can be left out. If you need to change the framerate in KEmulator, use Software\KLaunchFPS10, Software\KLaunchFPS15 or Software\KLaunchFPS60 as your Application Path. (It should be obvious what they set framerate to.) The default framerate is 30, although KEmulator is usually better at detecting what the framerate should be compared to FreeJ2ME.

	<BR CLEAR>		<BR CLEAR>
Line 45:		Line 44:
	* The JAR file should be placed by itself in the "content" folder. Make sure it is named differently from every other file in the Games directory already!		* The JAR file should be placed by itself in the "content" folder. Make sure it is named differently from every other file in the Games directory already!
	* The meta.txt file should be easy to understand if you take a few minutes to read it. See the available fields in the launcher itself.		* The meta.txt file should be easy to understand if you take a few minutes to read it. See the available fields in the launcher itself.
	**'''Extreme:''' ~~field is unused in Kahvibreak~~ (pornographic content is currently unaccepted).		**'''Extreme:''' tag games with NSFW/gore (pornographic content is currently unaccepted).
	**'''Platform:''' one of currently supported platforms, so either J2ME or Mophun.		**'''Platform:''' one of currently supported platforms, so either J2ME or Mophun.
	**'''Notes:''' anything wrong with the game or a helpful tip with its emulation.		**'''Notes:''' anything wrong with the game or a helpful tip with its emulation.

Viperision at 13:56, 23 April 2021

2021-04-23T13:56:50Z

Show changes

Prostagma at 17:17, 19 January 2021

2021-01-19T17:17:08Z

← Older revision		Revision as of 19:17, 19 January 2021
Line 46:		Line 46:

	[[Category:Kahvibreak]]		[[Category:Kahvibreak]]
	[[Category:Curation ~~Tutorials~~]]		[[Category:Curation Guides]]

Prostagma at 17:14, 19 January 2021

2021-01-19T17:14:10Z

← Older revision		Revision as of 19:14, 19 January 2021
Line 1:		Line 1:

	== Basic Instructions ==		== Basic Instructions ==

	* Download Kahvibreak. (You can use just the regular distro.)		* Download [https://bluemaxima.org/kahvibreak/ Kahvibreak]. (You can use just the regular distro.)

	* Add your JAR file to the Games folder. Please note that it has to be all one word, eg shorten "Gangstar - Crime City.jar" to "Gangstar.jar" (it's a limit with how KEmulator & FreeJ2ME load filenames over CMD)		* Add your JAR file to the Games folder. Please note that it has to be all one word, eg shorten "Gangstar - Crime City.jar" to "Gangstar.jar" (it's a limit with how KEmulator & FreeJ2ME load filenames over CMD)
Line 37:		Line 36:
	The curation is a holdover from the old format used by Flashpoint, so a few things remain the same.		The curation is a holdover from the old format used by Flashpoint, so a few things remain the same.

	* The [~~https://bluemaxima.org/flashpoint/datahub/Curation_Format~~#Logo logo] and [~~https://bluemaxima.org/flashpoint/datahub/Curation_Format~~#Screenshot screenshot] work the same way (correct procedure and extra examples are at the links). Save as PNG and put in the right place with the right name (logo.png / ss.png).		* The [[Curation Format#Logo\|logo]] and [[Curation Format#Screenshot\|screenshot]] work the same way (correct procedure and extra examples are at the links). Save as PNG and put in the right place with the right name (logo.png / ss.png).
	* The JAR file should be placed by itself in the 'content' folder. It would be nice if you could make sure that the file is named differently from every other file in the Games directory already, just to make things easier on me.		* The JAR file should be placed by itself in the 'content' folder. It would be nice if you could make sure that the file is named differently from every other file in the Games directory already, just to make things easier on me.
	* The meta.txt file should be easy to understand if you take a few minutes to read it.		* The meta.txt file should be easy to understand if you take a few minutes to read it.
Line 45:		Line 44:
	** Look through already included games in Kahvibreak for example genres.		** Look through already included games in Kahvibreak for example genres.
	* Make sure it's all in a folder with the name of the game just for easy organization, zip it up and send it in. You can send multiple games in one zip as long as they are in seperate folders.		* Make sure it's all in a folder with the name of the game just for easy organization, zip it up and send it in. You can send multiple games in one zip as long as they are in seperate folders.

			[[Category:Kahvibreak]]
			[[Category:Curation Tutorials]]

BlueMaxima at 01:53, 31 October 2019

2019-10-31T01:53:01Z

← Older revision		Revision as of 03:53, 31 October 2019
Line 20:		Line 20:
	* The fourth argument is the overall scale in %, in the example 200 is 200% so the 128x128 game will be shown as 256x256. Try and make your game fit in 720p screens, basic math is all you need to make sure the height won't be larger than 720.		* The fourth argument is the overall scale in %, in the example 200 is 200% so the 128x128 game will be shown as 256x256. Try and make your game fit in 720p screens, basic math is all you need to make sure the height won't be larger than 720.

	* The fifth argument is only for FreeJ2ME, it changes what framerate the game runs at. Accepted vaules are 60, 30 and 15. Not including this parameter will have the framerate be infinite~~, which~~ can ~~break some games~~.		* The fifth argument is only for FreeJ2ME, it changes what framerate the game runs at. Accepted vaules are 60, 30 and 15. Not including this parameter will have the framerate be infinite. You can do that; just be aware to include this if the game runs too fast.
	** This setting does not effect KEmulator and can be left out. If you need to change the framerate in KEmulator, use Software\KLaunchFPS10, Software\KLaunchFPS15 or Software\KLaunchFPS60 as your Application Path. (It should be obvious what they set framerate to.) The default framerate is 30, although KEmulator is usually better at detecting what the framerate should be compared to FreeJ2ME.		** This setting does not effect KEmulator and can be left out. If you need to change the framerate in KEmulator, use Software\KLaunchFPS10, Software\KLaunchFPS15 or Software\KLaunchFPS60 as your Application Path. (It should be obvious what they set framerate to.) The default framerate is 30, although KEmulator is usually better at detecting what the framerate should be compared to FreeJ2ME.

BlueMaxima at 06:32, 30 October 2019

2019-10-30T06:32:05Z

← Older revision		Revision as of 08:32, 30 October 2019
Line 20:		Line 20:
	* The fourth argument is the overall scale in %, in the example 200 is 200% so the 128x128 game will be shown as 256x256. Try and make your game fit in 720p screens, basic math is all you need to make sure the height won't be larger than 720.		* The fourth argument is the overall scale in %, in the example 200 is 200% so the 128x128 game will be shown as 256x256. Try and make your game fit in 720p screens, basic math is all you need to make sure the height won't be larger than 720.

	* The fifth argument is only for FreeJ2ME, it changes what framerate the game runs at. Accepted vaules are 60, 30 and 15. Not including this parameter will have the framerate be infinite, which can break some games. This setting does not effect KEmulator and can be left out. If you need to change the framerate in KEmulator, use Software\KLaunchFPS10, Software\KLaunchFPS15 or Software\KLaunchFPS60 as your Application Path. (It should be obvious what they set framerate to.)		* The fifth argument is only for FreeJ2ME, it changes what framerate the game runs at. Accepted vaules are 60, 30 and 15. Not including this parameter will have the framerate be infinite, which can break some games.
			** This setting does not effect KEmulator and can be left out. If you need to change the framerate in KEmulator, use Software\KLaunchFPS10, Software\KLaunchFPS15 or Software\KLaunchFPS60 as your Application Path. (It should be obvious what they set framerate to.) The default framerate is 30, although KEmulator is usually better at detecting what the framerate should be compared to FreeJ2ME.

	* Once you have these correct, hit the tick, launch the game by double clicking. If it looks and runs fine (play a bit through a couple of levels, preferably the whole game if you have the time) set it up like the example curation and send it in. If it doesn't work, try a few things:		* Once you have these correct, hit the tick, launch the game by double clicking. If it looks and runs fine (play a bit through a couple of levels, preferably the whole game if you have the time) set it up like the example curation and send it in. If it doesn't work, try a few things:

BlueMaxima at 06:09, 30 October 2019

2019-10-30T06:09:29Z

← Older revision		Revision as of 08:09, 30 October 2019
Line 12:		Line 12:
	* Launch Command is formatted like so for KEmulator and FreeJ2ME:		* Launch Command is formatted like so for KEmulator and FreeJ2ME:

	Gangstar.jar 128 128 200 30		Gangstar.jar 128 128 200 30

	* The first argument is the name of the .jar you want to load from the Games folder, simple enough.		* The first argument is the name of the .jar you want to load from the Games folder, simple enough.
Line 23:		Line 23:

	* Once you have these correct, hit the tick, launch the game by double clicking. If it looks and runs fine (play a bit through a couple of levels, preferably the whole game if you have the time) set it up like the example curation and send it in. If it doesn't work, try a few things:		* Once you have these correct, hit the tick, launch the game by double clicking. If it looks and runs fine (play a bit through a couple of levels, preferably the whole game if you have the time) set it up like the example curation and send it in. If it doesn't work, try a few things:
	* Use the other emulator (FreeLaunch.bat / KLaunch.bat)		** Use the other emulator (FreeLaunch.bat / KLaunch.bat)
	* Use the older version of KEmulator (KLaunch98.bat)		** Use the older version of KEmulator (KLaunch98.bat)
	* Use this Application Path: Software\KLaunchFS / Software\KLaunch98FS.bat		** Use this Application Path: Software\KLaunchFS / Software\KLaunch98FS.bat
	* If none of these work, report it to us on the Discord. Sometimes the emulators don't support certain games, sometimes the JAR is bad, sometimes it's an edge case that we may be able to fix.		** If none of these work, report it to us on the Discord. Sometimes the emulators don't support certain games, sometimes the JAR is bad, sometimes it's an edge case that we may be able to fix.

	* If you have multiple versions of the same game (resolutions, for example) find the largest resolution you can that works the best and have that be the default. Put in the Author Notes section the Launch Commands and names of other said versions. For example, if that Gangstar curation had two versions (say Gangstar.jar and Gangstar64x64.jar) you would use the regular Gangstar.jar in the Launch Command line and then on Author Notes include something like "64x64 version 'Gangstar64x64.jar 64 64 1200'" and I'll add the alt version manually when I add it.		* If you have multiple versions of the same game (resolutions, for example) find the largest resolution you can that works the best and have that be the default. Put in the Author Notes section the Launch Commands and names of other said versions. For example, if that Gangstar curation had two versions (say Gangstar.jar and Gangstar64x64.jar) you would use the regular Gangstar.jar in the Launch Command line and then on Author Notes include something like "64x64 version 'Gangstar64x64.jar 64 64 1200'" and I'll add the alt version manually when I add it.
Line 38:		Line 38:
	* The [https://bluemaxima.org/flashpoint/datahub/Curation_Format#Logo logo] and [https://bluemaxima.org/flashpoint/datahub/Curation_Format#Screenshot screenshot] work the same way (correct procedure and extra examples are at the links). Save as PNG and put in the right place with the right name (logo.png / ss.png).		* The [https://bluemaxima.org/flashpoint/datahub/Curation_Format#Logo logo] and [https://bluemaxima.org/flashpoint/datahub/Curation_Format#Screenshot screenshot] work the same way (correct procedure and extra examples are at the links). Save as PNG and put in the right place with the right name (logo.png / ss.png).
	* The JAR file should be placed by itself in the 'content' folder. It would be nice if you could make sure that the file is named differently from every other file in the Games directory already, just to make things easier on me.		* The JAR file should be placed by itself in the 'content' folder. It would be nice if you could make sure that the file is named differently from every other file in the Games directory already, just to make things easier on me.
	* The meta.txt file should be easy to understand if you take a few minutes to read it. Extreme should be "Yes" for games with pornographic images or extreme violence. Application Path and Launch Command you should know already. Platform is always J2ME. Look through already included games in Kahvibreak for example genres.		* The meta.txt file should be easy to understand if you take a few minutes to read it.
			** Extreme should be "Yes" for games with pornographic images or extreme violence.
			** Application Path and Launch Command you should know already.
			** Platform is always J2ME.
			** Look through already included games in Kahvibreak for example genres.
	* Make sure it's all in a folder with the name of the game just for easy organization, zip it up and send it in. You can send multiple games in one zip as long as they are in seperate folders.		* Make sure it's all in a folder with the name of the game just for easy organization, zip it up and send it in. You can send multiple games in one zip as long as they are in seperate folders.

BlueMaxima: Created page with " == Basic Instructions == * Download Kahvibreak. (You can use just the regular distro.) * Add your JAR file to the Games folder. Please note that it has to be all one word,..."

2019-10-30T06:07:43Z

Created page with " == Basic Instructions == * Download Kahvibreak. (You can use just the regular distro.) * Add your JAR file to the Games folder. Please note that it has to be all one word,..."

New page

== Basic Instructions ==

* Download Kahvibreak. (You can use just the regular distro.)

* Add your JAR file to the Games folder. Please note that it has to be all one word, eg shorten "Gangstar - Crime City.jar" to "Gangstar.jar" (it's a limit with how KEmulator & FreeJ2ME load filenames over CMD)

* Turn on Edit mode in the launcher (Config tab).

* Make a new entry by using New Game in the bottom right when on the game list, then use "Software\KLaunch.bat" for Application Path if you want KEmulator or "Software\FreeLaunch.bat" if you want FreeJ2ME. We also have an older version of KEmulator that you may want to try using if the JAR crashes, the sound is off, or if something else is weird; use "Software\KLaunch98.bat" for that one.

* Launch Command is formatted like so for KEmulator and FreeJ2ME:

Gangstar.jar 128 128 200 30

* The first argument is the name of the .jar you want to load from the Games folder, simple enough.

* The second and third argument are the width and height. There are multiple resolutions that can work; look for them on the zip file/site you get your JAR from. It will probably look wrong (cropped/in the top left corner) if the resolution is not correct.

* The fourth argument is the overall scale in %, in the example 200 is 200% so the 128x128 game will be shown as 256x256. Try and make your game fit in 720p screens, basic math is all you need to make sure the height won't be larger than 720.

* The fifth argument is only for FreeJ2ME, it changes what framerate the game runs at. Accepted vaules are 60, 30 and 15. Not including this parameter will have the framerate be infinite, which can break some games. This setting does not effect KEmulator and can be left out. If you need to change the framerate in KEmulator, use Software\KLaunchFPS10, Software\KLaunchFPS15 or Software\KLaunchFPS60 as your Application Path. (It should be obvious what they set framerate to.)

* Once you have these correct, hit the tick, launch the game by double clicking. If it looks and runs fine (play a bit through a couple of levels, preferably the whole game if you have the time) set it up like the example curation and send it in. If it doesn't work, try a few things:
* Use the other emulator (FreeLaunch.bat / KLaunch.bat)
* Use the older version of KEmulator (KLaunch98.bat)
* Use this Application Path: Software\KLaunchFS / Software\KLaunch98FS.bat
* If none of these work, report it to us on the Discord. Sometimes the emulators don't support certain games, sometimes the JAR is bad, sometimes it's an edge case that we may be able to fix.

* If you have multiple versions of the same game (resolutions, for example) find the largest resolution you can that works the best and have that be the default. Put in the Author Notes section the Launch Commands and names of other said versions. For example, if that Gangstar curation had two versions (say Gangstar.jar and Gangstar64x64.jar) you would use the regular Gangstar.jar in the Launch Command line and then on Author Notes include something like "64x64 version 'Gangstar64x64.jar 64 64 1200'" and I'll add the alt version manually when I add it.

== Example Curation ==

An example curation is available here which you should download and study: [https://bluemaxima.org/kahvibreak/Gangstar_Crime_City.zip Gangstar Crime City]

The curation is a holdover from the old format used by Flashpoint, so a few things remain the same.

* The [https://bluemaxima.org/flashpoint/datahub/Curation_Format#Logo logo] and [https://bluemaxima.org/flashpoint/datahub/Curation_Format#Screenshot screenshot] work the same way (correct procedure and extra examples are at the links). Save as PNG and put in the right place with the right name (logo.png / ss.png).
* The JAR file should be placed by itself in the 'content' folder. It would be nice if you could make sure that the file is named differently from every other file in the Games directory already, just to make things easier on me.
* The meta.txt file should be easy to understand if you take a few minutes to read it. Extreme should be "Yes" for games with pornographic images or extreme violence. Application Path and Launch Command you should know already. Platform is always J2ME. Look through already included games in Kahvibreak for example genres.
* Make sure it's all in a folder with the name of the game just for easy organization, zip it up and send it in. You can send multiple games in one zip as long as they are in seperate folders.