Implements change requests

- removes redundant `if (df::global::ui)` checks; and tested to ensure no segfaults cropped up like in the past times I've removed these
- removes useless `if (pause_lock)` pause lock is set when plugin initializes, even if pause lock was left null (since we technically don't need it, and that was the point of the null check) it still would be a useless check (actually an impediment preventing functionality)
- removes disabled interpose code
- removes lua linkage
- updates doc

extra:
- surrounds user input for tick frequency with `std::abs()` not that we would have ended up with a negative value, but it was probably a typo and this is easier than printing an error or letting it underflow past max int (on most systems)

docs/plugins/spectate.rst

@@ -19,10 +19,6 @@ When enabled, the plugin will automatically switch which dwarf is being
 followed periodically, preferring dwarves on z-levels with the highest
 job activity.
 
-To set features that toggle between two states, use {0,1} to specify
-which state the feature should be in. Anything else will take any positive
-value.
-
 Changes to plugin settings will be saved per world. Whether the plugin itself
 is enabled or not is not saved.
 
@@ -32,11 +28,11 @@ Examples
 ``spectate``
     The plugin reports its feature status.
 
-``spectate auto-unpause 1``
+``spectate enable auto-unpause``
     Enable the spectate plugin to automatically dismiss pause events caused
     by the game. Siege events are one example of such a game event.
 
-``spectate tick-interval 50``
+``spectate set tick-interval 50``
     Set the tick interval the followed dwarf can be changed at back to its
     default value.
 

plugins/spectate/CMakeLists.txt

@@ -5,4 +5,4 @@ SET(SOURCES
         spectate.cpp
         pause.cpp)
 
-dfhack_plugin(${PROJECT_NAME} ${SOURCES} LINK_LIBRARIES lua)
+dfhack_plugin(${PROJECT_NAME} ${SOURCES})

plugins/spectate/spectate.cpp

@@ -80,18 +80,6 @@ inline void saveConfig() {
     }
 }
 
-//struct player_pause_hook : df::viewscreen_dwarfmodest {
-//    typedef df::viewscreen_dwarfmodest interpose_base;
-//    DEFINE_VMETHOD_INTERPOSE(void, feed, (std::set<df::interface_key>* input)) {
-//        if ((ui->main.mode == ui_sidebar_mode::Default) && !allow_player_pause) {
-//            input->erase(interface_key::D_PAUSE);
-//        }
-//        INTERPOSE_NEXT(feed)(input);
-//    }
-//};
-//
-//IMPLEMENT_VMETHOD_INTERPOSE(player_pause_hook, feed);
-
 command_result spectate (color_ostream &out, std::vector <std::string> & parameters);
 
 DFhackCExport command_result plugin_init (color_ostream &out, std::vector <PluginCommand> &commands) {
@@ -206,7 +194,6 @@ void enable_auto_unpause(color_ostream &out, bool state) {
     // we don't need to do any of this yet if the plugin isn't enabled
     if (enabled) {
         // todo: R.E. UNDEAD_ATTACK event [still pausing regardless of announcement settings]
-        if(pause_lock) {
         // lock_collision == true means: enable_auto_unpause() was already invoked and didn't complete
         // The onupdate function above ensure the procedure properly completes, thus we only care about
         // state reversal here ergo `enabled != state`
@@ -251,7 +238,6 @@ void enable_auto_unpause(color_ostream &out, bool state) {
             pause_lock->reportLocks(out);
         }
     }
-    }
     unpause_enabled = state;
 }
 
@@ -277,7 +263,7 @@ command_result spectate (color_ostream &out, std::vector <std::string> & paramet
                 focus_jobs_enabled = state;
             } else if (parameters[1] == "tick-threshold" && set && parameters.size() == 3) {
                 try {
-                    tick_threshold = std::stol(parameters[2]);
+                    tick_threshold = std::abs(std::stol(parameters[2]));
                 } catch (const std::exception &e) {
                     out.printerr("%s\n", e.what());
                 }
@@ -298,7 +284,6 @@ command_result spectate (color_ostream &out, std::vector <std::string> & paramet
 
 // every tick check whether to decide to follow a dwarf
 void onTick(color_ostream& out, void* ptr) {
-    if (!df::global::ui) return;
     int32_t tick = df::global::world->frame_counter;
     if (our_dorf) {
         if (!Units::isAlive(our_dorf)) {
@@ -315,7 +300,6 @@ void onTick(color_ostream& out, void* ptr) {
             dwarves.push_back(unit);
         }
         std::uniform_int_distribution<uint64_t> follow_any(0, dwarves.size() - 1);
-        if (df::global::ui) {
             // if you're looking at a warning about a local address escaping, it means the unit* from dwarves (which aren't local)
             our_dorf = dwarves[follow_any(RNG)];
             df::global::ui->follow_unit = our_dorf->id;
@@ -324,7 +308,7 @@ void onTick(color_ostream& out, void* ptr) {
             if (!job_watched) {
                 timestamp = tick;
             }
-        }
+
     }
 }
 
@@ -345,8 +329,7 @@ void onJobStart(color_ostream& out, void* job_ptr) {
         std::bernoulli_distribution follow_job(p);
         if (!job->flags.bits.special && follow_job(RNG)) {
             job_watched = job;
-            df::unit* unit = Job::getWorker(job);
+            if (df::unit* unit = Job::getWorker(job)) {
-            if (df::global::ui && unit) {
                 our_dorf = unit;
                 df::global::ui->follow_unit = unit->id;
             }
@@ -360,11 +343,9 @@ void onJobStart(color_ostream& out, void* job_ptr) {
                 nonworkers.push_back(unit);
             }
             std::uniform_int_distribution<> follow_drunk(0, nonworkers.size() - 1);
-            if (df::global::ui) {
             df::global::ui->follow_unit = nonworkers[follow_drunk(RNG)]->id;
         }
     }
-    }
 }
 
 // every job completed can be forgotten about