Skip to content

AshinTop/dino3d

 
 

Repository files navigation

🦖 T-Rex Run 3D

A 3D pixel-style endless runner game featuring a T-Rex dinosaur. Forked from Priler/dino3d with enhanced features and improved gameplay.

🎮 online game:https://dinoonline.top

Screenshot

T-Rex Run 3D

Description

T-Rex Run 3D is a ThreeJS WebGL game made as an experiment.
All the graphics was hand crafted with Magica Voxel software, so that the overall feel and look of the game will be the same as original 2D game.

The code has NOT been polished and is provided "as is". There are a lot of code that are redundant and there are tons of improvements that can be made.

🦖 About the Game

T-Rex Run 3D is an exciting 3D pixel-style endless runner where you control a T-Rex dinosaur running through a prehistoric landscape. Jump over obstacles, collect coins, and set new high scores in this thrilling adventure!

Key Features

  • 3D Pixel Graphics: Retro-style visuals with modern 3D rendering
  • Endless Runner Gameplay: Run as far as you can while avoiding obstacles
  • Multiple Dinosaur Skins: Unlock new characters as you progress
  • Power-ups & Bonuses: Collect special items for temporary advantages
  • Global Leaderboard: Compete with players worldwide

🎮 How to Play

Controls

  • Jump: Press SPACEBAR or UP ARROW to jump over obstacles
  • Duck: Press DOWN ARROW to slide under low obstacles
  • Double Jump: Press jump twice in mid-air for extra height

Gameplay

  • Avoid cacti, rocks, and other dinosaurs
  • Collect coins to unlock new dinosaur skins
  • Watch for power-ups that provide temporary advantages
  • The game gets progressively harder as you run further

🚀 Getting Started

Prerequisites

  • Modern web browser (Chrome, Firefox, Safari, Edge)
  • JavaScript enabled

Installation

  1. Clone the repository:
git clone https://github.com/AshinTop/dino3d.git
  1. Navigate to the project directory:
cd dino3d
  1. Open index.html in your web browser

Online Play

Visit [https://dinoonline.top] to play directly in your browser.

🛠️ Technical Details

Built With

  • Three.js​ - 3D graphics rendering
  • Howler.js​ - Audio management
  • ​Custom Shaders​ - Visual effects and post-processing

✨ Enhancements from Original

This fork includes several improvements over the original Priler/dino3d:

🎨 Visual & UI Improvements

  • Modernized pixel-perfect design​ with enhanced visual aesthetics
  • Custom GitHub corner​ with diagonal split design matching the game's theme
  • Improved game information panel​ with scrollable content and better organization
  • Enhanced Start Game button​ with jumping animation and pixel-style effects
  • Better responsive design​ for various screen sizes

🎮 Gameplay Enhancements

  • Enhanced controls​ with smoother response and better feedback
  • Double jump mechanic​ for more advanced gameplay
  • Power-up system​ with temporary advantages and bonuses
  • Progressive difficulty scaling​ that adapts to player skill
  • Improved collision detection​ for more precise gameplay

💻 Technical Improvements

  • Optimized performance​ with better resource loading and management
  • Enhanced Three.js integration​ for smoother 3D rendering
  • Improved mobile compatibility​ with touch controls support
  • Better asset preloading​ to reduce loading times
  • Enhanced audio management​ with Howler.js integration

🌐 Web & SEO Features

  • Comprehensive SEO optimization​ with meta tags and descriptions
  • Open Graph integration​ for better social media sharing
  • Responsive design​ that works across devices
  • Accessibility improvements​ for better user experience
  • Browser compatibility​ enhancements

🎯 Game Features

Visual Style

  • Green and black color scheme​ matching the original aesthetic
  • Pixel-art inspired 3D graphics​ with retro charm
  • Dynamic lighting and shadows​ for immersive environments
  • Smooth animations and transitions​ between game states
  • Custom particle effects​ for visual feedback

Game Elements

  • Multiple obstacle types: Cacti, rocks, pits, and other dinosaurs
  • Collectible system: Coins, power-ups, and special items
  • Dynamic environment: Day/night cycle and varying terrain
  • Progression system: Increasing difficulty and unlockable content
  • Score multiplier​ for extended gameplay sessions

Player Experience

  • Intuitive controls​ with keyboard and touch support
  • Progressive learning curve​ suitable for all skill levels
  • Visual and audio feedback​ for all actions
  • High score tracking​ with local storage
  • Game state persistence​ between sessions

🤝 Contributing

We welcome contributions to improve T-Rex Run 3D! Here's how you can help:

How to Contribute

  1. Fork the project​ to your GitHub account
  2. Create a feature branch​ (git checkout -b feature/AmazingFeature)
  3. Commit your changes​ (git commit -m 'Add some AmazingFeature')
  4. Push to the branch​ (git push origin feature/AmazingFeature)
  5. Open a Pull Request​ with detailed description

Areas for Contribution

  • Bug fixes​ and performance improvements
  • New dinosaur characters​ and skins
  • Additional game modes​ and challenges
  • Mobile optimization​ and touch controls
  • Sound design​ and background music
  • Translation​ and localization support
  • Documentation​ improvements

Code Standards

  • Follow the existing code style and structure
  • Add comments for complex logic
  • Test changes across different browsers
  • Ensure mobile responsiveness
  • Update documentation when needed

📝 License

This project is based on the original dino3d by Priler. Please refer to the original repository for licensing information.

Attribution

🙏 Acknowledgments

Original Creator

  • Priler​ - For creating the original dino3d game concept and codebase

Technologies

  • Three.js community​ - 3D graphics library and ongoing support
  • Howler.js team​ - Audio management library
  • WebGL contributors​ - Underlying graphics technology

Contributors

  • All developers who have contributed to this fork
  • Testers and bug reporters
  • Community feedback and suggestions

📞 Support

Getting Help

If you encounter any issues or have questions:

  1. Check existing issues​ on the Issues page
  2. Search documentation​ for similar problems
  3. Create a new issue​ with detailed information:
    • Browser version and OS
    • Steps to reproduce the problem
    • Screenshots or error messages
    • Expected vs actual behavior

Community Support

  • GitHub Discussions​ for questions and ideas
  • Issue tracker​ for bug reports
  • Pull requests​ for code contributions

🌐 Connect

Project Links


Happy gaming!​​ 🦖🎮

Keep running, jumping, and having fun with T-Rex Run 3D!

Note: This project is a fan-made enhancement and is not officially affiliated with the original creators. All trademarks and copyrights belong to their respective owners.

About

🦖 Google Chrome T-Rex Run! in 3D (WebGL experiment)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 94.2%
  • SCSS 4.9%
  • Other 0.9%