LegacyShell WikiLegacyShell Wiki
Back to LegacyShell
Home
Wiki
Plugins
Docs
Back to LegacyShell
Home
Wiki
Plugins
Docs
  • Plugins

    • Plugin Docs

      • Default

        • Crackshot
        • Auto Restart Notifications
        • Auto Shop Notifications
        • Burnt Block Sets
        • Christmas Event
        • DeadInternet
        • FancyGraphics
        • Health Pack Item
        • Item ToolTips
        • LegacyAdmin
        • LegacyAnalytics
        • LegacySettings
        • LegacyShellCore
        • LegacyThemes
        • LegacyWeather
        • Modern Map Blocks
        • Modern Shell Guns
        • Modern Shell Hats
        • Modern Shell Stamps
        • Minerva
        • ParkourMode
        • Player Count Notifications
        • TimeMachine
        • Vaporwave Map Blocks
        • WhatsAppTheme
        • Zaxonius Custom Guns
      • Examples

        • Modern Shell Maps
    • List of plugins

Canonical source: plugins_default/timemachine/README.md - edit that file, not this page (this page is built live from it, nothing here is a tracked copy).

TimeMachine

A "throwback options" plugin - lets a player opt back into older (pre-0.17.0) visual behavior: bullet holes (removed in 0.17.0, this plugin reimplements the 0.9.0 and 0.1.0 versions), bullet smoke, a classic egg-splatter death animation, and classic frag particles - each individually toggleable, none on by default except bullet smoke.

Setup

Depends on Legacy Settings and Legacy Themes (dependencies.js declares both as "plugin" dependencies) - and, unlike Legacy Themes itself, actually declares what it depends on rather than relying on splice-order coincidence.

What it actually does

Adds a "Throwback Options" category under a shared "Graphics" settings tab (see Legacy Settings) with four options, each wired directly into a plugins.cancel-based replacement of a default rendering behavior:

OptionEffect when set
Bullet Holes0.17.0 (default, i.e. off), 0.9.0, or 0.1.0 - reimplements the old sprite-based bullet-hole decal system for the two non-default choices, using an original comment's own note that "0.17.0 removed them entirely."
Bullet SmokeOff cancels the default bulletHitEffect behavior entirely (plugins.cancel = !this.bulletSmoke.get()).
Classic Death AnimationOn cancels the default playerDeathAnimation and plays an egg-splatter (exploding shell/white/yolk mesh) animation instead.
Classic Frag ParticlesOn cancels the default shellFragBurstBefore particle burst and substitutes an old-style one.

Also registers a "Classic Shell Background" entry in Legacy Themes' style-pack list, alongside its graphics options.

A genuinely useful example of conditional plugins.cancel

Every plugins.cancel example elsewhere in this wiki (Replacing Core Behaviour) cancels unconditionally. This plugin's bulletHitEffect/playerDeathAnimation/shellFragBurstBefore handlers all set cancel based on a live user setting read at the moment the event fires (this.bulletSmoke.get(), etc.) - a real example of a default behavior being conditionally replaced per-player, per-preference, rather than always-on for everyone who has the plugin installed.


This page was drafted with AI assistance and reviewed for accuracy. If something looks wrong, please open a PR or flag it.

Prev
Player Count Notifications
Next
Vaporwave Map Blocks