td.nvim a Tower Defense game for Neovim

td.nvim is a tower defense game for Neovim. A great plugin to procrastinate without ever leaving your terminal.

tdnvim.mp4

Introduction

• You own a Tower represented by T in the center of your board.
• Different creeps will spawn as time moves on and they will move towards your tower in order to attack it.
• Your goal is to prevent your tower from running out of health points (HP ❤️). In order to do so you must buy upgrades.
• When you upgrade your tower, it gets more HP. Also you get more weapons to defend from the creeps.
• When you upgrade your weapons they become more powerful and deal more damage (⚔️).
• Some weapons have special powers like splash damage or the ability to slow down enemies.
• Each upgrade becomes more expensive.
• You earn money by killing the creeps.

Installation

Install td.nvim like any other plugin.

Using lazy.nvim

-- init.lua:
    {
    'efueyo/td.nvim',
    }

-- plugins/td.lua:
return {
    'efueyo/td.nvim',
    }

Using packer.nvim

use {
  'efueyo/td.nvim'
}

Playing the game

Whenever you kill a creep you will receive a variable amount of gold depending on the creep type and their level. Every round creeps get stronger, meaning more HP and more damage inflicted, but they also carry more gold. Different creeps have different combinations of HP, damage, gold carried and movement speed. Whenever you upgrade your tower its HP is increased to a new and higher max. You have different weapons that are unlocked as your tower is upgraded

• Gun Tower: Fast firing speed, limited damage.
• Cannon Tower: Slow firing speed, decent damage. Does splash damage.
• Ice Tower: Medium firing speed, minimal damage. Slows down enemies.
• Mine Tower: Medium firing speed, huge damage. Does splash damage.

Usage

Use the following commands or keymaps to interact with the Game

Command	Keymap	Description
:TDStart	N/A	Starts the game.
:TDToggle	<leader><leader>	Toggles the game (Start/Stop).
:TDStop	N/A	Stops the game.
:UpgradeTower	<leader>t	Upgrades the Tower.
:UpgradeGun	<leader>g	Upgrades the Gun weapon.
:UpgradeCannon	<leader>c	Upgrades the Cannon weapon.
:UpgradeIce	<leader>i	Upgrades the Ice weapon.
:UpgradeMine	<leader>m	Upgrades the Mine weapon.

Quotes about td.nvim that no one has ever said

A great plugin to procrastinate without ever leaving your terminal.

I tried playing td.nvim, but my config was so optimized, the enemies surrendered before even reaching my buffers.

In td.nvim, upgrading your tower is like upgrading your coding skills—painful at first, but once you get that golden parachute, you're unstoppable.

My tower in td.nvim has so many plugins, even the creeps are impressed. They stopped attacking and started submitting feature requests instead.

Waves of creeps in td.nvim are like syntax errors—inevitable and annoying, but you feel a sense of accomplishment when you finally squash them.

I thought I was a Vim ninja until I played td.nvim. Now I realize my ninja skills were just yanking and putting, not defending against pixelated invaders.

My tower defense strategy in td.nvim is like my code—chaotic, poorly documented, but somehow it works well enough to keep the creeps at bay.