Anchorage support plugin for poi

简体中文说明

Description

A plugin to help with Akashi's HP repair and Nosaki's morale boost, featuring similar timer mechanics for both:

• [x] estimate anchorage repair time (Akashi, Akashi Kai, Asahi Kai)
• [x] support paired repair bonus (Akashi + Asahi Kai at positions 1-2)
• [x] estimate morale boost timing (Nosaki)
• [x] notify upon ship repair completes
• [x] support combined operations (Akashi + Nosaki, or Akashi + Asahi Kai + Nosaki)

Limitations

• When you change the fleet composition, Kancolle API will not renew ships' HP, which may lead to inaccurate repair time estimation. You have to return to HQ screen to refresh ship data.

Basic mechanism

Akashi's anchorage repair (HP Recovery)

Requirements:

• Akashi (明石), Akashi Kai (明石改), or Asahi Kai (朝日改) must be fleet flagship (position 1)
• Flagship health: Must NOT be in moderate damage or worse (HP must be > 50% max HP)
• Flagship must not be in docking
• Base repair capability:
  • Akashi/Akashi Kai: Can repair herself and ship in 2nd slot (base: 2 ships) plus one ship slot per Ship Repair Facility equipped on flagship
  • Asahi Kai: Requires at least one Ship Repair Facility to repair even herself (base: 0 ships) plus one ship slot per Ship Repair Facility equipped on flagship
• Paired Repair Bonus: When Akashi series (Akashi/Akashi Kai) and Asahi Kai are at positions 1 and 2:
  • Valid pairs: Akashi + Asahi Kai OR Akashi Kai + Asahi Kai (in either order at positions 1-2)
  • 2nd position health requirement: Must be below minor damage (HP > 75% max HP) for paired bonus to work
  • SRF on position 2 also counts toward repair range
  • If position 2 has SRF equipped and is healthy, repair time is reduced to 5/6 of normal time (about 83.3%), per the Asahi Kai wiki entry
  • With maximum 5 total SRF, can repair up to 7 ships in combined fleet operations
• Repair target eligibility: Ships can be repaired when at minor damage or better (HP > 50% max HP)
• Target ships must not be in docking

Timer: 20 minutes minimum for HP repair

Nosaki's morale boost (Cond Recovery)

Requirements:

• Nosaki (or Kai) must be in position 1 or 2 to start the timer
• At port return after 15 minutes, eligibility is checked:
  • Nosaki must be fully supplied
  • Nosaki must be undamaged to below minor damage (HP > 75% max HP)
  • Nosaki cond ≥ 30
  • Nosaki not in expedition or docking
• If eligible, boosts morale (cond value) for all fleet members except Nosaki herself.
• Nosaki: +2 cond per application, Nosaki Kai: +3 cond per application
• Maximum cond: 54
• Target ships: not in docking (damage state doesn't matter)
• Consumes 1 fuel per ship boosted

Timer: 15 minutes minimum for morale boost

Combined Operation

• Both systems can work simultaneously in the same fleet
• Example configurations:
  • Akashi as flagship (repairs HP, 20min timer) + Nosaki in 2nd position (boosts morale, 15min timer)
  • Akashi/Akashi Kai as flagship + Asahi Kai in 2nd position = paired repair bonus (faster repair speed, extended range)
• Timer behavior per WIKI:
  • Repair timer (HP): Shared/global across all fleets ("修理時間のタイマーは共通") - when any fleet has a repair ship flagship, all fleets share the same timer
  • Morale timer (Nosaki): Shared/global across all fleets
• Paired Repair: When Akashi series (Akashi/Akashi Kai) and Asahi Kai occupy positions 1 and 2 (as described above), their Ship Repair Facilities are combined for extended range and faster repairs

Docking repair time

The formula base on HP loss, level and ship type is already proved, while this value is also given in API's api_ndock_time.

Repair time (Akashi)

• it takes at least 20 minutes to repair ships by at least 1 HP
• Above 20 minutes, the amount will be the same as ships in docking, rounded down.
• In the docking time formula, a 30-second bias is always added; the docking is actually finished, however, 1 minute earlier. And anchorage repair time will be rounded up to next minute.

Timer reset rules

The plugin approximates game-side timers from Kancolle API response events and the already-updated local store state. The references describe in-game screen behavior, so implementation is based on the closest observable API transitions.

• Repair timer (global/shared):

  • Starts when a repair ship becomes flagship and the fleet can perform anchorage repair.
  • Advances after a port update if at least 20 minutes have elapsed and repair is active.
  • Resets when the fleet whose flagship is a repair ship changes composition.
  • Also resets when a ship is moved from a repair-ship fleet into another fleet.
  • Fleet preset loading does not reset the timer.
  • Sending a fleet containing a repair ship to expedition resets the shared timer if another repair fleet remains active; otherwise the plugin clears the timer until repair becomes active again.
  • Expedition return itself does not reset the timer.
  • Sortie, exercise, equipment changes, development, and other-fleet operations do not reset the timer.

• Nosaki timer (global/shared):

  • Starts when Nosaki/Nosaki Kai is in position 1 or 2.
  • At port return after 15 minutes, morale boost is applied if Nosaki and target ships satisfy the eligibility checks.
  • Resets when a fleet with Nosaki/Nosaki Kai in position 1 or 2 changes composition.
  • Fleet preset loading and companion fleet-wide disband do not reset the timer.
  • The timer is shared even when multiple fleets operate Nosaki.
  • Sortie and exercise do not reset the timer. Expedition and docking are eligibility checks for applying the effect.

Timer Behavior (Important!)

• Both timers are global/shared: Per WIKI, both repair timer and Nosaki timer are shared across fleets.
• Repair timer: "修理時間のタイマーは共通" - fleets with repair ship flagships share one repair timer.
• Nosaki timer: "複数の艦隊でそれぞれ野埼を運用する場合でもタイマーは共通" - Nosaki timer is shared across all fleets.
• Fleet presets: Loading composition presets does not reset either timer.
• Ship remodeling: Nosaki → Nosaki Kai remodeling does not reset the Nosaki timer; the plugin treats remodeling as non-resetting for timer purposes.
• Works everywhere: Both systems work in all fleets (1-4) and strike force (7 ships).

Corner cases

Following corner cases are not taken into consideration, thus the result may not behave as it could be.

• changing Akashi's slot items, more precisely, changing the numbers of Ship Repair Facilities (for Akashi),
• exact server-side behavior for rare edge cases not directly visible from API response timing.

Implemented Features

✓ Fleet preset loading doesn't reset timers ✓ Nosaki timer is global across all fleets ✓ Cross-fleet ship swaps reset affected repair/Nosaki timers when appropriate ✓ Expedition departure resets or clears the repair timer depending on whether another repair fleet remains active ✓ Morale Queue watch list persists to the plugin data file under Poi's app data directory ✓ Ship remodeling (including Nosaki → Nosaki Kai) doesn't reset timer

Changelog

v0.1

Initial version

v0.2

Now the timer is always displayed for those who want to make use of composition preset bug.

v0.3

The timer reset rules corrected

• Returning to HQ within 20 minutes won't reset the timer,
• Changing fleet composition within 20 minutes will immediately reset the timer. Otherwise a return to HQ is required

References

• https://wikiwiki.jp/kancolle/%E6%98%8E%E7%9F%B3
• https://wikiwiki.jp/kancolle/%E6%9C%9D%E6%97%A5%E6%94%B9 (paired repair details: "修理に要する時間が本来の5/6")
• https://twitter.com/KanColle_STAFF/status/1688966979607224320 (official paired repair announcement)
• https://wikiwiki.jp/kancolle/%E9%87%8E%E5%9F%BC
• https://wikiwiki.jp/kancolle/%E7%96%B2%E5%8A%B4%E5%BA%A6
• https://gist.githubusercontent.com/fujieda/440fa64d310c2b6960f3/raw
• https://kamigame.jp/%E8%89%A6%E3%81%93%E3%82%8C/%E6%94%BB%E7%95%A5%E3%82%AC%E3%82%A4%E3%83%89/%E6%98%8E%E7%9F%B3%E3%81%AE%E6%B3%8A%E5%9C%B0%E4%BF%AE%E7%90%86.html
• https://en.kancollewiki.net/wiki/Auxiliary_Ships_Mechanics

License

MIT