You have to return things you want to retrieve from other files. This is how storyboard works, because you use a bunch of storyboard.* functions to create each scene, and then type return scene at the end to pass the data on.

Similarly I can make a lua file myself like this;

1
2
3
4

--cool.lua
local rabbits = {2,3,4}
 
return rabbits

If I require in cool.lua elsewhere,

1
2

local cool = require("cool")
print( cool[1] ) -- 2

The trick with your code is that just because you're returning something doesn't mean it will attach everything in it:

1
2
3

local rabbit = {}
rabbit.name = "robert" -- this is part of rabbit, so it goes with it
blob = "derek" -- this is not a part of rabbit, so it doesn't go with it

So you can type return objects in doc1, but that won't give you the scene table, which means in doc2, scene == objects.

I'd be cautious about using "scene" as a variable if you plan on using Storyboard, as it's used a lot in the docs, and you may inadvertently overwrite it.

To gain access to you data easier, I would assign it to a "player" key:

In doc1.lua:

1
2
3
4
5
6
7

local sceneData = {
  objects = {
    player = { name = "player", img = "art/player.png", start_x = -170, start_y = -4720 }
  }
}
 
return sceneData

In doc2.lua

1
2
3
4
5
6
7

local function enemy(self, event)
   local sceneData = require("doc1")
   -- ??? Something goes here.
  if(self.y <= sceneData.objects.player.start_y) then
    print("SUCCESS")
  end
end

Just a suggestion. Cheers.