mosheberman / mbtileparser Goto Github PK

MBTileParser is a game engine written using pure UIKit in the days before SpriteKit.

License: Other

Objective-C 99.49% Ruby 0.51%

game-engine objective-c tmx texturepacker tmx-files dialog uikit sprites

mbtileparser's Introduction

MBTileParser

Look Ma, a game engine! Running on UIKit! MBTileParser is a small game engine that supports loading TMX files and TexturePacker files directly into UIKit.

Screenshots & Demo:

I've uploaded a demo video to YouTube.

Here's what the game engine looks like in action:

Features:

MBTileParser can do five things right now. Load maps, load sprites, display dialog, take input via virtual controls, and retain game state.

Load maps: MBTileParser is actually the name of a class in the engine. You can load TMX files. Use the MBMapViewController class for this.
Load sprites: You can load sprites using MBSpriteView. MBMovableSpriteView supports movement too.
Display Dialog: Load and parse dialog trees, using MBDialogTree. (Support for end actions is now implemented.)
Take Input: Create custom virtual game controls, using the MBJoystick and MBControllerButton classes. You can also use the included layout.
Manage Games State: The latest update includes state support (in progress) which allows you to track levels, stamina, score, items, dialog, and more.

Setting it Up:

Clone into, or download, the repository. Copy the folder called MBGameEngine and import MBGameEngine.h.

You can also use cocoapods:

pod 'MBTileParser'

Technical Requirements:

MBTileParser requires the iOS 7 SDK and ARC.

Even if your project doesn't use ARC, you'll want to compile MBTileParser with ARC. Use the -fobjc-arc compiler flag for that.

Notes:

About the TMX format, Tiled, and TexturePacker: The TMX file format is used by Tiled, a tool which helps you make world maps for games by tiling images. (You can download Tiled here). The TMX format is explained in detail on the tiled GitHub repository wiki. The developer of TexturePacker, Andreas Löw, was kind enough to give me a license a while back. Thanks Andreas! You can get TexturePacker from his website.

Parting Words: Please take a moment to star this repository and pass it along to anyone who you think might enjoy it. I also encourage you to look at my other repositories. You might find something you like.

Always have fun, because game engines are fun.

License:

MBTileParser is hereby released under the following modified MIT License.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), with the exception of the sample graphics and audio files, to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

The "non-code", graphics and audio, may not be used except to build and run the demo on your own machines.

The artwork is copyrighted by Allan Simpson. He has created it for a project we are working on. You may not use it for anything except to play with the game engine on your own machine(s). Sorry, it's not mine to let you give out.

Finally, if you make any awesome games with this, please let me know!

mbtileparser's People

Contributors

Stargazers

Watchers

mbtileparser's Issues

There's a leak

There's a leak at 131 line of MBMapView.
CGImageRef image = CGImageCreateWithImageInRect(tilesheet.CGImage, tileRect);

Maybe should add Release line to 140
CGImageRelease(image);

Centering thumb image fails if there's not background image set.

Centering thumb image fails if background image isn't set, because there's no background image...

The joystick should dispatch movement at regular intervals

As it is now, the joystick dispatches movement events when it is touched, or when touches move. The correct, more comfortable way to use the joystick would be to support dispatches at regular intervals. Perhaps this should be done in the gameControllerViewController instance.

Then separate them within a cocoapods-subspec if you only need the SpriteKit version, e.g. Mac OS.

Adopt SpriteKit

I'd like to move to SpriteKit if possible. Not a terribly complicated thing to do here - I think there are only a few places that need changes.