CEOBots - Single DLL Drop-in
==========================

Requires the original 32-bit Endless Online 0.4.59 client and its game assets.
This ZIP contains winmm.dll and this README. All CEOBots program code, Python
libraries, native dependencies and supplied gameplay presets are inside the DLL.
The DLL loads its embedded components in memory; it does not extract a runtime
folder or dependency cache. Keep the filename winmm.dll for automatic loading.

INSTALL
1. Close Endless Online.
2. Copy winmm.dll into the game folder, beside the normal Endless.exe.
3. Launch the normal game client. Press F9 to open CEOBots.

0.4.59 COMPATIBILITY UPDATE
Updates the native game function addresses, changed object fields and packet
identities for the supplied 0.4.59 client. Original movement timing, route
planning and server acknowledgements are preserved. The refresh default
is now eight seconds. Unsupported older client executables are rejected.
Compilation, native byte signatures and package contents were checked;
live gameplay verification is pending the owner's manual test.

GAME RENDER
Game Render is the only supported renderer. The panel uses the original
client's offscreen surface, font functions and theme-aware graphics loader.
CEOBots owns its dashboard control state and gameplay settings; server/quest
dialog click handlers are not repurposed as bot controls. No Windows child
controls or separately created fonts are used for the visible panel.
The old overlay edition has been retired. Its former download URL now serves
the Game Render DLL.

CODE HARDENING
Private gameplay modules are compiled to Python 3.11 bytecode before embedding;
readable Python gameplay source is not included in the DLL. Gameplay bytecode,
bundled JSON settings/catalogs and presets use AES-256-GCM authenticated
encryption with a fresh independent random key and nonce for each resource.
The native loader decrypts resources only in memory, checks their authentication
tags and wipes temporary plaintext buffers. Symmetric keys are reconstructed
only for the current resource and destroyed immediately after decryption;
there is no shared process-lifetime payload key. The Python resource API refuses
raw gameplay bytecode reads; the native loader creates code objects directly.
It writes no decrypted program
files or bytecode cache. Native debug symbols are stripped. The original
Python runtime, standard library and third-party license/source notices remain
normal embedded dependencies; this is not encryption of the entire executable.

This makes casual extraction harder, not impossible. A determined person can
inspect running code. Credentials and other private user data are excluded
from the delivered DLL, rather than protected by this build key.
Saved Quick Login details keep their separate local user-scope encryption.

PROPRIETARY NOTICE
Copyright (c) 2026 CEOBots project owner. All rights reserved in CEOBots-authored
proprietary components. Extraction or decryption to copy the protected
implementation, decompilation, disassembly and redistribution of modified
copies are not authorized without the rights holder's written permission,
except as permitted by applicable law or an applicable license. This applies
to manual and AI-assisted analysis alike. The full notice is embedded in the
DLL as licenses/CEOBots/NOTICE.txt. Third-party licenses remain unchanged.
This notice states the owner's terms; it does not technically control analysis
tools or establish that every form of reverse engineering is illegal.

UPGRADING THE OLDER CeraControls BUILD
Install the current original 0.4.59 client before using this DLL. Preserve
your saved settings and profiles when upgrading from 0.4.58.
For an older modified CeraControls EXE, restore its backed-up original before removing CeraControls.dll
and CEOBots-runtime. The old prepared EXE imports CeraControls.dll and must not
be left in place after that DLL is removed. The single-DLL build uses the
original game EXE. Preserve your saved settings and profiles.

PROTON / WINE
Enable the native winmm override for this game. For a Steam Proton launch,
the launch option is:
  WINEDLLOVERRIDES="winmm=n,b" %command%
In winecfg, add winmm under Libraries and set it to Native, then Builtin.
Launch the normal game EXE after configuring the override.

CONTROLS
F8   Start/stop automation using the selected shared Melee/Mage mode.
F9   Show/hide the native in-game panel.
F10  Switch between full mode and the compact chat-area dock.
Esc  Hide the panel.
Bring the game window into focus to use these hotkeys. Automation is designed
to continue when another application has focus. Every launch starts stopped.

GAMEPLAY
The panel has two tabs: Combat and Combat & Go. Combat starts Melee or Mage
using the selected shared mode. Combat & Go adds destination map/NPC selection,
Travel only, Go + Fight and Stop. Expand the targeting, mage, healing, boost,
pickup/loot, Settings or Login sections to edit shared settings in either tab.
Other gameplay tools are grouped under the collapsed More tools section.

Set home captures the current map and X/Y and keeps your healing thresholds.
Combat & Go uses your shared combat/spell/boost/healing/targeting/loot settings.
Choosing a Go + Fight NPC adds it to the shared Valid list when needed; all
existing entries are kept and Avoid entries must be removed before targeting.
It retains the selected destination and uses the original CeraBot walking,
boat and ferry planner to return after death or a map change until Stop/F8.
Friendly and service NPCs, including shops, quest actors, bankers and boat/ferry
NPCs, are solid obstacles. Their roles come from the current client's NPC PUB
and their tiles from live NPC positions. The original pathfinder routes around
them; combat monsters keep the original tile-sharing policy. An optional dash
cannot cross a friendly actor. A blocked next step invalidates only its cached
local path so the original planner can find a detour without restarting trips.
With Home & Rest enabled and a retreat threshold set, Combat & Go retreats
when HP reaches that shared threshold, including in mage mode. Mage combat
also keeps its MP retreat trigger. The trip finds a reachable healing tile
clear of combat NPCs, warp tiles, damage tiles and occupied destinations;
it repositions if monsters approach. Attacks and offensive boost/tag casts
pause during retreat. It uses your configured self-heal and return threshold
before resuming the same trip, without overwriting your saved home position.
Normal combat and Go + Fight run CeraBot's original automation thread, wakeups,
walk pacing, real server acknowledgements, target selection and attack timing.
The DLL sends those original movement/face/attack packets through the game's
packet writer. Local animation runs separately and cannot delay or reject an
action using the keyboard controller's extra movement or attack gates.
Local walks use the client's next-step animation buffer so the final stage
can join the following step without an extra idle animation update. Local
actions and incoming gameplay updates request a normal scene redraw; seeing
combat damage or movement should not depend on a network F12 refresh.
The viewport keeps repainting while native damage numbers or local walking
are pending/active, then repaints once more to clear the last animation frame.
An already-sent walk target is not discarded just because the displayed
character has fallen behind; the client's own animator can catch up again.
Nearby NPC probe updates preserve genuine queued damage numbers for the same
living NPC. New spawn/death cleanup still belongs to the original client.
The embedded adapter accepts the current batched hit/death packet layout;
explicit deaths from any player clear the target, and late probe replies
cannot bring that dead occupant back into the bot's target list.
The game thread also publishes its real NPC death/removal state to the bot.
A native death flag clears attack, pursuit and mage-tag locks regardless of
which player got the kill, and wakes the original combat thread to retarget.
Previously observed actors removed by the client are evicted without inventing
a kill. Loading/incomplete snapshots never mean all NPCs died; world/session
and actor identity separate old slot occupants from genuine new spawns.
The original animation clock, 405 ms packet pacing and server walk replies
remain responsible for their normal work.
Routes avoid adjacent groups of player-occupied tiles. After an ordinary
player-share step, other player tiles remain obstacles for the original
seven-second share-gate window, so the planner detours instead of chaining
another ghost attempt. The current tile remains escapable. Moving players
only invalidate a cached route when they obstruct its next step; optional
dash shortcuts obey the same player obstacles.
The client sends the normal F12 map-refresh packet every 8 seconds by default
while logged in, including while unfocused or combat is OFF. The F12 refresh
control at the top of Settings lets you save a custom interval in whole seconds
(1-86400, or 0 to turn it off). The default is eight seconds.
Full and compact share this client preference;
it survives restarts and is separate from character gameplay profiles.
The first refresh follows one full interval after entering the game or saving
a new rate. Login/loading screens skip sends; temporary map changes keep the
timer and do not restart a travel route.
NPC Valid/Priority/Avoid filters support multiple named saved entries.
In Combat > NPC targeting & combat, search by part of an NPC name or its numeric ID, select
one or more matching names, choose Valid/Priority/Avoid, then Add selected.
Clear restores the full NPC catalog. Search filters only the picker; the three
saved lists stay visible and retain their separate Remove selected controls.
Search text follows you between full/compact modes and tab changes.
Pickup & loot and More tools > Harvest include searchable item dropdowns and
named saved Pickup/Reject lists, with Add and Remove controls. Search by any
part of an item name or its ID; clear the search to browse the full dropdown.
Only selected items is OFF by default: normal pickup still collects everything
allowed by the original rules except rejected items. Enable it to restrict
floor loot to the saved Pickup list; an empty enabled list picks up nothing.
Rejected items always take priority, including in melee, mage and Combat & Go.
Combat Harvest has its own searchable named reject list. The original harvest
resource/map selections remain separate from floor loot pickup filters.
The pickup mode and lists are shared between full/compact and saved profiles.
Normal melee, mage and Combat & Go stop at 1,000,000 daily kill EXP unless
Bypass daily EXP cap is enabled under NPC targeting & combat. A capped Combat & Go
trip is canceled instead of restarting combat. The daily reset, Clear Daily
Caps or the bypass option makes combat available again; Daily Route keeps
its own cap/advance rules and does not use the session bypass.
Harvest uses named resources and map lists. Profiles includes sanitized
map-named presets and native JSON/INI import, save, load and delete controls.
CAPTCHA REWARD uses the original CeraBot word-game decoder and the current
client session value. Its separate auto-submit toggle is in More tools > Chat; like the
original dashboard, it can respond while combat is stopped. Chat also shows
whether a response is waiting or queued. Disable auto-submit to play manually.

QUICK LOGIN AND RELOG
Press F9 before logging in to open Login & reconnect. The shared full/compact
panel also has a Quick Login button beside its status area. Enter your account,
password and optional character name, then press Quick login. A blank character
uses the last character seen in this client session, or the first roster slot
on a fresh launch. The DLL calls the original client login, connection and
character-selection functions on the game thread; it uses no desktop input.

Remember saves account/password encrypted for the local Windows user with
DPAPI (the current prefix under Wine/Proton). With Remember off, credentials
stay in process memory and are forgotten when the client closes. Password
text is masked before publishing the native render snapshot. Forget login
removes the saved encrypted credentials and disables automatic options.

Reconnect if disconnected retries after the configured 5-3600 second delay.
Scheduled relog accepts an interval of 0-10080 minutes and/or local 24-hour
times separated by commas, such as 06:00, 18:30. Interval 0 disables the
interval trigger. Automatic options are OFF by default; enabling them does
not make a fresh launch log in automatically. A connected map/boat loading
screen does not count as a disconnect.

Resume previous job is optional and OFF by default. When enabled, reconnect
retains the active Combat & Go destination or supported gameplay job, along
with Daily Route progress, and resumes after real server world entry. F8 or
Stop cancels a pending login/resume. Invalid credentials or missing character
selection stop automatic retries and leave the original game message visible.
Compilation and static review do not establish live login/relog correctness.

SETTINGS AND GAME DATA
The DLL uses the game's existing graphics, maps and PUB files. Saved profiles,
settings and learned gameplay data are user data, stored in CEOBots-data;
UI preferences use CeraControls.ini. They are not extracted program libraries.
Existing user settings are kept. No account credentials, account databases,
private reference logs or reference instruction files are included.

CURRENT STATUS
This is an in-progress dashboard transfer, not a completed 1:1 release.
Remaining differences include the original interactive map, complete Loadout
row actions/owned-item choices, some saved-list and Daily Route row editors,
and in-panel ChatAI provider setup.
Automatic craft-route execution is unfinished in both the supplied web
scheduler and this build.
The single-DLL build has passed compilation and static dependency checks.
Live gameplay verification of this build has not been performed.

LICENSES / SOURCE NOTICES
Python's license is embedded as LICENSE.txt. Python: https://www.python.org/
MemoryModule's unmodified source, MPL-2.0 license and origin information are
embedded under licenses/MemoryModule/. The same upstream covered source is at:
https://github.com/fancycode/MemoryModule/tree/5f83e41c3a3e7c6e8284a5c1afa5a38790809461
