Hology
Hology
Hology
  • 👋Welcome to Hology Docs
  • Getting started
    • Introduction to Hology
    • The first steps
    • Editor basics
      • Flying in scenes
      • Placing objects
      • Select objects
      • Transform
      • Grouping objects
      • Duplicate
    • Starter project - Third person shooter
  • Tutorials
    • Rolling ball - Gameplay programming
    • Character movement programming
    • Character AI behavior
  • Release
    • Distribution
      • Discord Activities
      • Facebook Instant Games
      • Upload to Itch.io
      • Host with GitHub Pages
      • Publishing to Steam
      • iOS and Android
  • Assets
    • 3D Models
      • Custom collision shapes
      • Material slots
    • Materials
    • Textures
    • Prefabs
  • Gameplay
    • Actors
      • Creating actor classes
      • Actor parameters
      • Actor components
      • Actor lifecycle
      • Spawning actors
      • Moving actors
    • Services
      • Load assets
    • Player input
    • Collision detection
    • Physics
      • Physics body types
      • Applying forces
      • Ray casting
    • Trigger volumes
    • Character movement
    • Pointer events
    • Animation
      • Animation system
      • Character Animation
      • Animation State Machine
    • Sound
      • Audio parameter
    • World
    • Navigation
  • Shaders
    • Introduction to shaders
    • Creating shaders
    • Shader parameters
    • Typescript shaders
      • Types
      • Math functions
      • Attributes
      • Varying
      • Uniforms
      • Textures
      • Arrays
      • Select
      • Lighting
    • Painted materials
    • Water shader tutorial
  • Level design
    • Landscape sculpting
    • Landscape painting
    • Grass
  • User Interfaces
    • Creating user interfaces
    • Using React
    • VR
  • Visual Effects
    • Introduction to VFX
    • VFX Assets
  • Integrations
    • Arcweave
Powered by GitBook
On this page
  • Download the project
  • Run the project
  • Opening the project in the editor
  • Where to go from here
  • Continue building on the project
  1. Getting started

Starter project - Third person shooter

PreviousDuplicateNextRolling ball - Gameplay programming

Last updated 1 year ago

To jumpstart your development, a small project has been created. This project can be used as a starting point for a game of your own or just a way to learn how a project can be structured.

The following sections will explain how to get setup with the project.

Download the project

git clone https://github.com/hologyengine/starter-third-person-shooter.git
cd starter-third-person-shooter
npm ci

Run the project

npm run dev

Opening the project in the editor

In the editor's launcher, click on "Open an existing project". Navigate to the project's folder.

To make sure you select the correct folder. The folder you see should have the following folders in it:

Where to go from here

Take a look around the code base to see how actors and components are implemented. When reading about other subjects in the docs, you can refer back to this project to see how features are being used in practice.

Continue building on the project

You now have the basic building blocks to start creating games. The only limit is your imagination.

Here are some ideas of things you could try to build

  • Limited ammunition system: Keep track of how much ammo the player has. Display this in the user interface and prevent the player from shooting when it has no more ammo. Create an ammo box actor with a trigger volume to let the player pick up ammo by running over them.

  • Add your own models: Replace the character model and others in the scene.

  • Enemies: Spawn enemy characters that are controlled by AI that will shoot the player. Implement a health component to keep track of each character's health.

Provided that you have Git installed, you can run the following commands in your terminal to download the project. If you don't have Git installed, you can download it from .

Once the project is downloaded, run the following command from within the project's directory. This should run the game as a website that you can view by opening in your browser.

https://git-scm.com/download/
http://localhost:5173/
LogoGitHub - hologyengine/starter-third-person-shooter: A starting point for a third person shooter game with Hology EngineGitHub