Skip to content

DennisSchwartz/hawkthorne-journey

 
 

Repository files navigation

Journey to the Center of Hawkthorne

This 2d platformer is based on Community's Digital Estate Planning episode. It's built using the LÖVE game engine. Please report any issues or bugs you have with the game!

Downloads ( play the game )

If you already have love installed, you can download the hawkthorne.love file and run the game from there.

Linux users: Install LÖVE. You'll need at least version 0.8.0. (Standard Ubuntu packages are too old.) After installing LÖVE, download the .love file and run it. Everyone gets to play!

Development ( contribute to the game )

All discussion and development takes place on /r/hawkthorne. If you have any contributions you'd like to submit, either open a pull request or create a post on the subreddit.

Getting your build up and running

  1. Create a free GitHub account - https://github.com/plans
  2. Set up Git on your machine - https://help.github.com/articles/set-up-git
  3. Fork this repository ( click the 'fork' button at the top of this page )
  4. Follow the machine specific instructions below

OSX

  1. Be sure to complete the steps above to get started

  2. Install the most recent version of LÖVE - http://love2d.org

  3. Open Terminal

  4. Make a command line alias to love

     $ alias love='/Applications/love.app/Contents/MacOS/love'
    
  5. Add the alias to ~/.bash_profile so it works the next time you reboot

     $ echo alias love='/Applications/love.app/Contents/MacOS/love' >> ~/.bash_profile
    
  6. Download and install the latest version of tmx2lua

     $ curl -OL https://github.com/downloads/kyleconroy/tmx2lua/tmx2lua.osx.tar
     $ tar -xf tmx2lua.osx.tar
     $ sudo cp tmx2lua /usr/bin/tmx2lua
    
  7. Clone your newly forked repository and change directory Note: You have to copy your repository url from github ( ex: https://github.com/username/hawkthorne-journey.git )

     $ git clone (your forked repository url)
     $ cd hawkthorne-journey
    
  8. Build your maps ( this must be done each time you change a map )

     $ make maps
    
  9. Run the game

     $ love src
    

    If you are testing a specific level, you can optionally pass that level name using the --level option

     $ love src --level=valley
    

    You can also test a specific level as a specific character

     $ love src --level=valley --character=troy
    

Linux

  1. Be sure to complete the steps above to get started

  2. Install the most recent version of LÖVE - http://love2d.org

    NOTE: Many package managers have a very old version of love. Make sure that you have at least v0.8.0 or the game will not launch

  3. Open Terminal

  4. Download the latest version of tmx2lua

    Linux 64-bit:

     $ wget https://github.com/downloads/kyleconroy/tmx2lua/tmx2lua.linux64.tar
    

    Linux 32-bit:

     $ wget https://github.com/downloads/kyleconroy/tmx2lua/tmx2lua.linux.tar
    
  5. Install tmx2lua

     $ tar -xf tmx2lua.linux*.tar
     $ sudo cp tmx2lua /usr/bin/tmx2lua
    
  6. Clone your newly forked repository and change directory Note: You have to copy your repository url from github ( ex: https://github.com/username/hawkthorne-journey.git )

     $ git clone (your forked repository url)
     $ cd hawkthorne-journey
    
  7. Build your maps ( this must be done each time you change a map )

     $ make maps
    
  8. Run the game

     $ love src
    

    If you are testing a specific level, you can optionally pass that level name using the --level option

     $ love src --level=valley
    

    You can also test a specific level as a specific character

     $ love src --level=valley --character=troy
    

Windows

  1. Be sure to complete the steps above to get started

  2. Install the most recent version of LÖVE - http://love2d.org

    a) add the love directory to the path

     $ set Path=%Path%;(love directory)
    

    OR

    a) navigate to "Control Panel > System"

    b) click "Advanced system settings"

    c) in the "Advanced" tab click the "Environment Variables" button

    d) add the following to the path ";(love directory)"

  3. Download the tmx converter:

    a) download and unzip the tmx2lua file for your system

    32 bit: https://github.com/downloads/kyleconroy/tmx2lua/tmx2lua.windows32.zip

    or

    64 bit: https://github.com/downloads/kyleconroy/tmx2lua/tmx2lua.windows64.zip

    b) move tmx2lua to your "hawkthorne-journey" directory

     $ mv (tmx directory)/tmx2lua.windows64 hawkthorne-journey/
    
  4. Clone your newly forked repository and change directory Note: You have to copy your repository url from github ( ex: https://github.com/username/hawkthorne-journey.git )

     $ git clone (your forked repository url)
     $ cd hawkthorne-journey
    

    or

     go to github.com, navigate to your repository and click the "Clone in Windows" button
    
  5. Build your maps ( this must be done each time you change a map )

     $ make
    
  6. Run the game

     $ love src
    

    If you are testing a specific level, you can optionally pass that level name using the --level option

     $ love src --level=valley
    

    You can also test a specific level as a specific character

     $ love src --level=valley --character=troy
    

Notes:

i)

    $ make && love src

will only build necessary maps and then run the executable.

ii)

    $ love src --console

will additionally launch a handy console for print statements

License

Unless otherwise noted, this code is licensed under the MIT License.

Artwork and audio files are licensed under CC BY-NC 3.0. Artwork includes all .png, .psd, .ogg, and .wav files.

About

Digital Estate Planning: The Game

Resources

License

Stars

Watchers

Forks

Packages

No packages published